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 Component ，以便识别平台相关的拖动启动手势。

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

一旦DragGestureRecognizer与特定相关Component它将注册对相应的监听器接口Component ，以跟踪传递到输入事件Component 。

一旦DragGestureRecognizer Component上的一系列事件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表示此拖放操作中使用的操作类型。

构造方法摘要

构造方法

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以用于此拖放操作， Component此 DragGestureRecognizer应该“观察”用于拖动启动手势，以及此拖放操作支持的操作。
protected	DragGestureRecognizer(DragSource ds, Component c, int sa, DragGestureListener dgl) 构造一个新的 DragGestureRecognizer给定 DragSource用于这个拖放操作， Component这个 DragGestureRecognizer应该“观察”拖动启动手势，这个拖放操作支持的动作， 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的Listeners与Component子类必须覆盖此方法
void	removeDragGestureListener(DragGestureListener dgl) 取消注册当前的DragGestureListener
void	resetRecognizer() 重置识别器，如果其当前识别手势，则忽略它。
void	setComponent(Component c) 将DragGestureRecognizer与registerListeners（）和unregisterListeners（）相关联的组件设置为适当的副作用。
void	setSourceActions(int actions) 此方法为此拖放操作设置允许的源拖动操作。
protected abstract void	unregisterListeners() 使用Component子类取消注册此DragGestureRecognizer的侦听器必须覆盖此方法

Methods inherited from class java.lang.Object

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

字段详细信息

dragSource

protected DragSource dragSource

该 DragSource与此相关 DragGestureRecognizer 。

component

protected Component component

该 Component与此相关 DragGestureRecognizer 。

dragGestureListener

protected transient DragGestureListener dragGestureListener

该 DragGestureListener与此相关 DragGestureRecognizer 。

sourceActions

protected int sourceActions

int表示此拖放操作中使用的操作类型。

events

protected ArrayList<InputEvent> events

DragGestureRecognizer “识别”作为触发拖动的“手势”的事件列表（按顺序）。

构造方法详细信息

DragGestureRecognizer

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

构造一个新的 DragGestureRecognizer给定 DragSource用于这个拖放操作， Component这个 DragGestureRecognizer应该“观察”拖动启动手势，这个拖放操作支持的动作，以及 DragGestureListener通知一次已经检测到拖动启动手势。

参数

ds - DragSource这个 DragGestureRecognizer将用于处理拖放操作

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

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

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

异常

IllegalArgumentException - 如果ds是 null 。

DragGestureRecognizer

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

构建一个新的 DragGestureRecognizer给定 DragSource用于此拖放操作， Component此 DragGestureRecognizer应该“观察”用于拖动启动手势，以及此拖放操作支持的操作。

参数

ds - DragSource这个 DragGestureRecognizer将用于处理拖放操作

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

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

异常

IllegalArgumentException - 如果ds是 null 。

DragGestureRecognizer

protected DragGestureRecognizer(DragSource ds,
                                Component c)

构建一个新的 DragGestureRecognizer给定 DragSource用于此拖放操作， Component此 DragGestureRecognizer应该“观察”拖动启动手势。

参数

ds - DragSource这个 DragGestureRecognizer将用于处理拖放操作

c - Component这个DragGestureRecognizer应该“观察”事件流，以便检测拖动启动手势。 如果这个值是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的Listeners与Component子类必须覆盖此方法

unregisterListeners

protected abstract void unregisterListeners()

使用Component子类取消注册此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。

结果

当前允许的来源动作

setSourceActions

public void setSourceActions(int actions)

此方法为此拖放操作设置允许的源拖动操作。

参数

actions - 允许的来源拖动动作

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 - 如果dgl不是（等于）当前注册的 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不是有效值，将被忽略。