java.awt.dnd

Class DragGestureRecognizer

java.lang.Object

java.awt.dnd.DragGestureRecognizer

All Implemented Interfaces:

Serializable

已知直接子类：

MouseDragGestureRecognizer

public abstract class DragGestureRecognizer
extends Object
implements Serializable

的 DragGestureRecognizer是一个可以与一个特定的 Component为了识别依赖于平台的拖启动手势相关平台依赖的听众的规范抽象基类。

适当的DragGestureRecognizer子类的实例是从一个特定Component相关的DragSource获得，或从Toolkit对象通过其createDragGestureRecognizer()方法。

一旦DragGestureRecognizer是与一个特定的Component将登记相应的监听器接口以Component跟踪输入事件传递到Component相关。

一旦DragGestureRecognizer标识序列对Component事件拖累引发的姿态，它将通过调用其gestureRecognized()方法通知其单播DragGestureListener。

当混凝土DragGestureRecognizer实例检测拖启动手势在Component是相关联的，它发射一DragGestureEvent的DragGestureListener对DragGestureListener事件的单播事件源注册。这DragGestureListener是引起相关DragSource启动拖放操作（如适用）。

另请参见：

DragGestureListener， DragGestureEvent， DragSource， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Component	component 与此相关的 Component DragGestureRecognizer。
protected DragGestureListener	dragGestureListener 与此相关的 DragGestureListener DragGestureRecognizer。
protected DragSource	dragSource 与此相关的 DragSource DragGestureRecognizer。
protected ArrayList<InputEvent>	events 事件列表（按顺序）， DragGestureRecognizer“公认”为“手势”引发的阻力。
protected int	sourceActions 代表类型的 int（S）行动（S）进行拖放操作。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	DragGestureRecognizer(DragSource ds) 构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作。
protected	DragGestureRecognizer(DragSource ds, Component c) 构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，和 Component这 DragGestureRecognizer应该“观察”拖动起始姿势。
protected	DragGestureRecognizer(DragSource ds, Component c, int sa) 构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，这 DragGestureRecognizer应该“观察”引发的 Component拖动手势，和行动（S）支持这个拖放操作。
protected	DragGestureRecognizer(DragSource ds, Component c, int sa, DragGestureListener dgl) 构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，这 DragGestureRecognizer应该“观察”引发的 Component拖动手势，动作（S）这个拖放操作的支持，和 DragGestureListener通知一旦拖启动手势已经被发现。

方法摘要

Modifier and Type	Method and Description
void	addDragGestureListener(DragGestureListener dgl) 登记一个新的 DragGestureListener。
protected void	appendEvent(InputEvent awtie) 通过这个识别器的组件注册监听器应记录所有事件，是公认的事件，去组成一个拖放启动手势通过这个API的系列的一部分。
protected void	fireDragGestureRecognized(int dragAction, Point p) 通知draggesturelistener发生拖放启动手势。
Component	getComponent() 这个方法返回 Component是“观察”的 DragGestureRecognizer拖动起始姿势。
DragSource	getDragSource() 这个方法返回 DragSource这 DragGestureRecognizer将用以处理拖放操作。
int	getSourceActions() 此方法返回表示动作类型int（）这个拖放操作支持。
InputEvent	getTriggerEvent() 此方法返回启动拖放操作的事件序列中的第一个事件。
protected abstract void	registerListeners() 登记本DragGestureRecognizer的听众与组件的子类必须重写此方法
void	removeDragGestureListener(DragGestureListener dgl) 注销当前DragGestureListener
void	resetRecognizer() 重置系统，如果其目前识别手势，忽略它。
void	setComponent(Component c) 设置组件的draggesturerecognizer与registerlisteners()和unregisterlisteners()相关的被称为作为一个副作用是适当的。
void	setSourceActions(int actions) 此方法设置此拖放操作的允许源拖放操作（S）。
protected abstract void	unregisterListeners() 注销这DragGestureRecognizer的听众与组件的子类必须重写此方法

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dragSource

protected DragSource dragSource

与此相关的 DragSource DragGestureRecognizer。

component

protected Component component

与此相关的 Component DragGestureRecognizer。

dragGestureListener

protected transient DragGestureListener dragGestureListener

与此相关的 DragGestureListener DragGestureRecognizer。

sourceActions

protected int sourceActions

代表类型的 int（S）行动（S）进行拖放操作。

events

protected ArrayList<InputEvent> events

事件列表（按顺序）， DragGestureRecognizer“公认”为“手势”引发的阻力。

Constructor Detail

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c,
                                int sa,
                                DragGestureListener dgl)

构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，这 DragGestureRecognizer应该“观察”引发的 Component拖动手势，动作（S）这个拖放操作的支持，和 DragGestureListener通知一旦拖启动手势已经被发现。

参数

ds - DragSource这 DragGestureRecognizer将使用过程中的拖放操作

c -这 DragGestureRecognizer应该“观察”的事件流的 Component，为了检测拖启动手势。如果这个值是 null的 DragGestureRecognizer，不与任何 Component相关。

sa -集（逻辑或）的，这 DnDConstants拖放操作支持

dgl - DragGestureRecognizer通知时，拖动手势检测

异常

IllegalArgumentException如果DS是 null。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c,
                                int sa)

构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，这 DragGestureRecognizer应该“观察”引发的 Component拖动手势，和行动（S）支持这个拖放操作。

参数

ds - DragSource这 DragGestureRecognizer将使用过程中的拖放操作

c -这 DragGestureRecognizer应该“观察”的事件流的 Component，为了检测拖启动手势。如果这个值是 null的 DragGestureRecognizer，不与任何 Component相关。

sa -集（逻辑或）的 DnDConstants这个拖放操作将支持

异常

IllegalArgumentException如果DS是 null。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c)

构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作，和 Component这 DragGestureRecognizer应该“观察”拖动起始姿势。

参数

ds - DragSource这 DragGestureRecognizer将使用过程中的拖放操作

c -这 DragGestureRecognizer应该“观察”的事件流的 Component，为了检测拖启动手势。如果这个值是 null的 DragGestureRecognizer，不与任何 Component相关。

异常

IllegalArgumentException如果DS是 null。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds)

构建一个新的 DragGestureRecognizer给予 DragSource用于拖放操作。

参数

ds - DragSource这 DragGestureRecognizer将使用过程中的拖放操作

异常

IllegalArgumentException如果DS是 null。

方法详细信息

registerListeners

protected abstract void registerListeners()

登记本DragGestureRecognizer的听众与组件的子类必须重写此方法

unregisterListeners

protected abstract void unregisterListeners()

注销这DragGestureRecognizer的听众与组件的子类必须重写此方法

getDragSource

public DragSource getDragSource()

这个方法返回 DragSource这 DragGestureRecognizer将用以处理拖放操作。

结果

DragSource

getComponent

public Component getComponent()

这个方法返回 Component是“观察”的 DragGestureRecognizer拖动起始姿势。

结果

这是DragGestureRecognizer与组件

setComponent

public void setComponent(Component c)

设置组件的draggesturerecognizer与registerlisteners()和unregisterlisteners()相关的被称为作为一个副作用是适当的。

参数

c - Component或 null

getSourceActions

public int getSourceActions()

此方法返回表示动作类型int（）这个拖放操作支持。

结果

当前允许的源程序（s）

setSourceActions

public void setSourceActions(int actions)

此方法设置此拖放操作的允许源拖放操作（S）。

参数

actions -允许源拖动操作（S）

getTriggerEvent

public InputEvent getTriggerEvent()

此方法返回启动拖放操作的事件序列中的第一个事件。

结果

引发拖动手势的初始事件

resetRecognizer

public void resetRecognizer()

重置系统，如果其目前识别手势，忽略它。

addDragGestureListener

public void addDragGestureListener(DragGestureListener dgl)
                            throws TooManyListenersException

登记一个新的 DragGestureListener。

参数

dgl - DragGestureListener与这个 DragGestureRecognizer

登记。

异常

TooManyListenersException -如果一个 DragGestureListener已添加。

removeDragGestureListener

public void removeDragGestureListener(DragGestureListener dgl)

注销当前draggesturelistener

参数

dgl - DragGestureListener注销这 DragGestureRecognizer

异常

如果我们不 IllegalArgumentException（等于）目前注册 DragGestureListener。

fireDragGestureRecognized

protected void fireDragGestureRecognized(int dragAction,
                                         Point p)

通知draggesturelistener发生拖放启动手势。然后重置状态的识别。

参数

dragAction由用户最初选择的动作手势

p -点（在元件坐标）的手势起源

appendEvent

protected void appendEvent(InputEvent awtie)

通过这个识别器的组件注册监听器应记录所有事件，是公认的事件，去组成一个拖放启动手势通过这个API的系列的一部分。

这种方法是通过一个DragGestureRecognizer实现添加一个InputEvent类（它认为是一个在一系列的事件，包括拖放操作）对这DragGestureRecognizer保持内部事件的数组。

参数

awtie - InputEvent添加到事件 DragGestureRecognizer内部阵列。注意， null不是有效值，并将被忽略。