- java.lang.Object
-
- java.awt.dnd.DragGestureRecognizer
-
- 实现的所有接口
-
Serializable
- 已知直接子类:
-
MouseDragGestureRecognizer
public abstract class DragGestureRecognizer extends Object implements Serializable
DragGestureRecognizer
是一个抽象基类,用于指定与平台相关的侦听器,该侦听器可以与特定的Component
关联,以便识别与平台相关的拖动启动手势。适当
DragGestureRecognizer
子类的实例被从所获得的DragSource
与特定相关联的Component
,或者从Toolkit
对象通过其createDragGestureRecognizer()
方法。一旦
DragGestureRecognizer
与特定的Component
相关联,它将在该Component
上注册相应的侦听器接口,以跟踪传送到Component
的输入事件。一旦
DragGestureRecognizer
识别关于事件的序列Component
作为拖动启动动作时,将通知单播DragGestureListener
通过调用其gestureRecognized()
方法。当具体的
DragGestureRecognizer
实例检测到与其关联的Component
上的拖动启动手势时,它会向其单播事件源上注册的DragGestureListener
触发DragGestureEvent
以获取DragGestureListener
事件。DragGestureListener
负责使关联的DragSource
启动拖放操作(如果适用)。- 另请参见:
-
DragGestureListener
,DragGestureEvent
,DragSource
, Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 protected Component
component
Component
与此DragGestureRecognizer
相关联。protected DragGestureListener
dragGestureListener
DragGestureListener
与此DragGestureRecognizer
相关联。protected DragSource
dragSource
DragSource
与此DragGestureRecognizer
相关联。protected ArrayList<InputEvent>
events
DragGestureRecognizer
“识别”为触发拖动的“手势”的事件列表(按顺序)。protected int
sourceActions
int
表示此拖放操作中使用的操作类型。
-
构造方法摘要
构造方法 变量 构造器 描述 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
通知一次已检测到拖动启动手势。
-
方法摘要
所有方法 实例方法 抽象方法 具体的方法 变量和类型 方法 描述 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()
使用Component子类注册此DragGestureRecognizer的Listeners必须覆盖此方法void
removeDragGestureListener(DragGestureListener dgl)
取消注册当前的DragGestureListenervoid
resetRecognizer()
重置识别器,如果它当前正在识别手势,则忽略它。void
setComponent(Component c)
设置DragGestureRecognizer与registerListeners()相关联的Component和unregisterListeners()作为副作用被调用。void
setSourceActions(int actions)
此方法为此拖放操作设置允许的源拖动操作。protected abstract void
unregisterListeners()
使用Component子类取消注册此DragGestureRecognizer的Listeners必须覆盖此方法
-
-
-
字段详细信息
-
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
-设定的(逻辑OR)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
-设定的(逻辑OR)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()
使用Component子类注册此DragGestureRecognizer的Listeners必须覆盖此方法
-
unregisterListeners
protected abstract void unregisterListeners()
使用Component子类取消注册此DragGestureRecognizer的Listeners必须覆盖此方法
-
getDragSource
public DragSource getDragSource()
此方法返回DragSource
这将使用DragGestureRecognizer
来处理拖放操作。- 结果
- DragSource
-
getComponent
public Component getComponent()
此方法返回由Component
“观察”的DragGestureRecognizer
用于拖动启动手势。- 结果
- 与DragGestureRecognizer关联的Component
-
setComponent
public void setComponent(Component c)
设置DragGestureRecognizer与registerListeners()相关联的Component和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
不是有效值,将被忽略。
-
-