- java.lang.Object
-
- java.util.EventObject
-
- java.awt.dnd.DragSourceEvent
-
- java.awt.dnd.DragSourceDragEvent
-
- All Implemented Interfaces:
-
Serializable
public class DragSourceDragEvent extends DragSourceEvent
该DragSourceDragEvent
从交付DragSourceContextPeer
,通过DragSourceContext
,到DragSourceListener
与注册DragSourceContext
和与其关联DragSource
。DragSourceDragEvent
报告目标放置操作和反映拖动操作的当前状态的用户放置操作。目标放置操作是
DnDConstants
中的一个,表示当拖动源支持该拖放操作时,当前放置目标所选择的放置操作,或DnDConstants.ACTION_NONE
如果拖放源不支持此放置操作)。用户放置操作取决于拖动源支持的放置操作和用户选择的放置操作。 用户可以在拖动操作期间按修改键来选择放置操作:
Ctrl + Shift -> ACTION_LINK Ctrl -> ACTION_COPY Shift -> ACTION_MOVE
如果用户选择放置操作,则用户放置操作是DnDConstants
中的一个,表示当拖动源支持该放置操作时所选择的放置操作,或DnDConstants.ACTION_NONE
如果拖放源不支持此放置操作。如果用户没有选drop操作,一组
DnDConstants
表示设置拖动源支持的放置动作中搜索DnDConstants.ACTION_MOVE
,然后DnDConstants.ACTION_COPY
,然后为DnDConstants.ACTION_LINK
和用户drop操作是找到的第一个常量。 如果没有找到常量,则用户删除操作是DnDConstants.ACTION_NONE
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class java.util.EventObject
source
-
-
构造方法摘要
构造方法 Constructor 描述 DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)
构造一个DragSourceDragEvent
。DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)
构造一个DragSourceDragEvent
给定指定的DragSourceContext
,用户放置操作,目标放置操作,修饰符和坐标。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 int
getDropAction()
此方法返回目标放置操作与拖动源支持的放置操作集合的逻辑交集。int
getGestureModifiers()
该方法返回表示与用户手势相关联的输入设备修饰符的当前状态的int
。int
getGestureModifiersEx()
该方法返回表示与用户手势相关联的输入设备扩展修饰符的当前状态的int
。int
getTargetActions()
此方法返回目标放置操作。int
getUserAction()
此方法返回用户放置操作。-
Methods inherited from class java.awt.dnd.DragSourceEvent
getDragSourceContext, getLocation, getX, getY
-
Methods inherited from class java.util.EventObject
getSource, toString
-
-
-
-
构造方法详细信息
-
DragSourceDragEvent
public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)
构造一个DragSourceDragEvent
。 该类通常由DragSourceContextPeer
实例化,而不是直接由客户端代码实例化。 此DragSourceDragEvent
的坐标未指定,因此getLocation
将为此事件返回null
。参数
dropAction
和action
应该是表示单个动作的DnDConstants
中的一个。 参数modifiers
应该是旧的java.awt.event.InputEvent.*_MASK
常量的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK
常量的按位掩码。 此构造方法不抛出无效任何异常dropAction
,action
和modifiers
。- 参数
-
dsc
- 用于管理此事件的通知的DragSourceContext
。 -
dropAction
- 用户删除操作。 -
action
- 目标下降动作。 -
modifiers
- 在事件期间修改器键(shift,ctrl,alt,meta)应该使用扩展_DOWN_MASK或旧_MASK修饰符,但是两个模型不应该在一个事件中混合。 优选使用延伸改性剂。 - 异常
-
IllegalArgumentException
- 如果dsc
是null
。 - 另请参见:
-
InputEvent
,DragSourceEvent.getLocation()
-
DragSourceDragEvent
public DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)
构造一个DragSourceDragEvent
给定指定的DragSourceContext
,用户放置操作,目标放置操作,修饰符和坐标。参数
dropAction
和action
应该是表示单个动作的DnDConstants
中的一个。 参数modifiers
应该是旧的java.awt.event.InputEvent.*_MASK
常数的按位掩码或扩展的java.awt.event.InputEvent.*_DOWN_MASK
常量的按位掩码。 此构造方法不抛出无效任何异常dropAction
,action
和modifiers
。- 参数
-
dsc
- 与此事件有关的DragSourceContext
。 -
dropAction
- 用户删除操作。 -
action
- 目标删除操作。 -
modifiers
- 在事件期间修改器键(shift,ctrl,alt,meta)应该使用扩展_DOWN_MASK或旧_MASK修饰符,但是两个模型不应该在一个事件中混合。 优选使用延伸改性剂。 -
x
- 光标位置的水平坐标 -
y
- 光标位置的垂直坐标 - 异常
-
IllegalArgumentException
- 如果dsc
是null
。 - 从以下版本开始:
- 1.4
- 另请参见:
-
InputEvent
-
-
方法详细信息
-
getTargetActions
public int getTargetActions()
此方法返回目标放置操作。- 结果
- 目标放下动作。
-
getGestureModifiers
public int getGestureModifiers()
该方法返回表示与用户手势相关联的输入设备修饰符的当前状态的int
。 通常这些将是鼠标按钮或键盘修饰符。如果传递给构造函数的
modifiers
无效,则此方法不会更改它们。- 结果
- 输入设备修改器的当前状态
-
getGestureModifiersEx
public int getGestureModifiersEx()
- 结果
- 输入设备的当前状态扩展修改器
- 从以下版本开始:
- 1.4
-
getUserAction
public int getUserAction()
此方法返回用户放置操作。- 结果
- 用户放下动作。
-
getDropAction
public int getDropAction()
此方法返回目标放置操作与拖动源支持的放置操作集合的逻辑交集。- 结果
- 目标放置操作与拖动源支持的放置操作集合的逻辑交集。
-
-