站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

DragSourceDragEvent (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 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

通过 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。

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

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

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

getUserAction

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

返回：
用户放置动作。

getDropAction

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

返回：
用户放置动作、目标放置动作和拖动源支持的放置动作集合的逻辑交集。
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM 2 Platform
Standard Ed. 5.0
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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