DragSourceDragEvent

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.dnd
类 DragSourceDragEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent
          java.awt.dnd.DragSourceDragEvent

所有已实现的接口：: Serializable

public class DragSourceDragEvent
extends DragSourceEvent
extends DragSourceEvent

通过 DragSourceContext，将 DragSourceDragEvent 从 DragSourceContextPeer 传递给向 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` 此类通常是由 `DragSourceContextPeer` 实例化，而不是直接由客户机代码实例化。
`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。

参数 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)

构造一个具有指定 DragSourceContext、用户放置动作、目标放置动作、组合键和坐标的 DragSourceDragEvent。

参数：: 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()

此方法返回一个 int 值，表示与用户动作关联的输入设备扩展组合键的当前状态。请参阅 InputEvent.getModifiersEx()

如果传递给构造方法的 modifiers 无效，则原封不动返回此方法。

返回：: 输入设备扩展组合键的当前状态
从以下版本开始：: 1.4

getUserAction

public int getUserAction()

此方法返回用户放置动作。

返回：: 用户放置动作。

getDropAction

public int getDropAction()

此方法返回用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。

返回：: 用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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