DragSourceDragEvent

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 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，将 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`。
`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`

构造方法详细信息

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()