JavaTM Platform
Standard Ed. 6

java.awt.dnd
类 DragSourceDragEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.dnd.DragSourceEvent
          继承者 java.awt.dnd.DragSourceDragEvent
所有已实现的接口:
Serializable

public class DragSourceDragEvent
extends DragSourceEvent

通过 DragSourceContext,将 DragSourceDragEventDragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener

DragSourceDragEvent 报告可反映当前拖动操作状态的目标放置动作用户放置动作

目标放置动作DnDConstants 之一:如果拖动源支持此放置动作,则为当前放置目标所选择的放置动作;如果拖动源不支持此放置动作,则为 DnDConstants.ACTION_NONE

用户放置动作 则取决于拖动源所支持的放置动作和用户所选择的放置动作。用户可在拖动操作期间按下修改键来选择放置动作:

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 
如果用户选择了某个放置动作,则用户放置动作DnDConstants 之一:如果拖动源支持此放置动作,则为所选择的放置动作;如果拖动源不支持此放置动作,则为 DnDConstants.ACTION_NONE

如果用户未选择某个放置动作,则在 DnDConstants 集合(表示拖动源支持的放置动作集合)中搜索 DnDConstants.ACTION_MOVE,然后是 DnDConstants.ACTION_COPY,最后是 DnDConstants.ACTION_LINK,找到的第一个常量就是用户放置动作。 如果未找到常量,则用户放置动作DnDConstants.ACTION_NONE

从以下版本开始:
1.2
另请参见:
序列化表格

字段摘要
 
从类 java.util.EventObject 继承的字段
source
 
构造方法摘要
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers)
          构造一个 DragSourceDragEvent
DragSourceDragEvent(DragSourceContext dsc, int dropAction, int action, int modifiers, int x, int y)
          构造一个具有指定 DragSourceContext、用户放置动作、目标放置动作、修改键和坐标的 DragSourceDragEvent
 
方法摘要
 int getDropAction()
          此方法返回目标放置动作与拖动源支持的放置动作集合的逻辑交集。
 int getGestureModifiers()
          此方法返回一个 int 值,表示与用户动作关联的输入设备修饰符的当前状态。
 int getGestureModifiersEx()
          此方法返回一个 int 值,表示与用户动作关联的输入设备扩展修饰符的当前状态。
 int getTargetActions()
          此方法返回目标放置动作。
 int getUserAction()
          此方法返回用户放置动作。
 
从类 java.awt.dnd.DragSourceEvent 继承的方法
getDragSourceContext, getLocation, getX, getY
 
从类 java.util.EventObject 继承的方法
getSource, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers)
构造一个 DragSourceDragEvent。 此类通常由 DragSourceContextPeer 实例化,而不是直接由客户机代码实例化。未指定此 DragSourceDragEvent 的坐标,所以 getLocation 将对此事件返回 null

参数 dropActionaction 应该是表示单个动作的 DnDConstants 之一。参数 modifiers 应该是旧 java.awt.event.InputEvent.*_MASK 常量的位掩码,或者是扩展 java.awt.event.InputEvent.*_DOWN_MASK 常量的位掩码。此构造方法对无效的 dropActionactionmodifiers 不抛出任何异常。

参数:
dsc - 用来管理此事件通知的 DragSourceContext
dropAction - 用户放置动作。
action - 目标放置动作。
modifiers - 事件期间按下的修改键(shift、ctrl、alt、meta)。应该使用扩展的 _DOWN_MASK 修饰符或旧的 _MASK 修饰符,但是在一个事件中不应混用两种模型。首选扩展的修饰符。
抛出:
IllegalArgumentException - 如果 dscnull
另请参见:
InputEvent, DragSourceEvent.getLocation()

DragSourceDragEvent

public DragSourceDragEvent(DragSourceContext dsc,
                           int dropAction,
                           int action,
                           int modifiers,
                           int x,
                           int y)
构造一个具有指定 DragSourceContext、用户放置动作、目标放置动作、修改键和坐标的 DragSourceDragEvent

参数 dropActionaction 应该是表示单个动作的 DnDConstants 之一。参数 modifiers 应该是旧 java.awt.event.InputEvent.*_MASK 常量的位掩码,或者是扩展 java.awt.event.InputEvent.*_DOWN_MASK 常量的位掩码。此构造方法对无效的 dropActionactionmodifiers 不抛出任何异常。

参数:
dsc - 与此事件关联的 DragSourceContext
dropAction - 用户放置动作。
action - 目标放置动作。
modifiers - 事件期间按下的修改键(shift、ctrl、alt、meta)。应该使用扩展的 _DOWN_MASK 修饰符或旧的 _MASK 修饰符,但是在一个事件中不应混用两种模型。首选扩展的修饰符。
x - 光标位置的水平坐标
y - 光标位置的垂直坐标
抛出:
IllegalArgumentException - 如果 dscnull
从以下版本开始:
1.4
另请参见:
InputEvent
方法详细信息

getTargetActions

public int getTargetActions()
此方法返回目标放置动作。

返回:
目标放置动作。

getGestureModifiers

public int getGestureModifiers()
此方法返回一个 int 值,表示与用户动作关联的输入设备修饰符的当前状态。通常是鼠标按键或键盘修饰符。

如果传递给构造方法的 modifiers 无效,则此方法按原样返回它们。

返回:
输入设备修饰符的当前状态

getGestureModifiersEx

public int getGestureModifiersEx()
此方法返回一个 int 值,表示与用户动作关联的输入设备扩展修饰符的当前状态。请参阅 InputEvent.getModifiersEx()

如果传递给构造方法的 modifiers 无效,则此方法按原样返回它们。

返回:
输入设备扩展修饰符的当前状态
从以下版本开始:
1.4

getUserAction

public int getUserAction()
此方法返回用户放置动作。

返回:
用户放置动作。

getDropAction

public int getDropAction()
此方法返回目标放置动作与拖动源支持的放置动作集合的逻辑交集。

返回:
目标放置动作与拖动源支持的放置动作集合的逻辑交集。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策