- java.lang.Object
-
- java.awt.dnd.DragGestureRecognizer
-
- All Implemented Interfaces:
-
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
与其相关联,它触发一个DragGestureEvent
到DragGestureListener
单播事件源上用于注册DragGestureListener
事件。 此DragGestureListener
负责导致关联的DragSource
启动拖放操作(如果适用)。- 另请参见:
-
DragGestureListener
,DragGestureEvent
,DragSource
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 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 描述 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 方法 描述 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)
取消注册当前的DragGestureListenervoid
resetRecognizer()
重置识别器,如果其当前识别手势,则忽略它。void
setComponent(Component c)
将DragGestureRecognizer与registerListeners()和unregisterListeners()相关联的组件设置为适当的副作用。void
setSourceActions(int actions)
此方法为此拖放操作设置允许的源拖动操作。protected abstract void
unregisterListeners()
使用Component子类取消注册此DragGestureRecognizer的侦听器必须覆盖此方法
-
-
-
字段详细信息
-
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
到拖动手势时通知的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()
注册该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
不是有效值,将被忽略。
-
-