JavaTM 2 Platform
Standard Ed. 5.0

软件包 java.awt.dnd

Drag 和 Drop 是一种直接操作操作,在许多图形用户界面系统中都会遇到它,它提供了一种机制,能够在两个与 GUI 中显示元素逻辑相关的实体之间传输信息。

请参见:
          描述

接口摘要
Autoscroll 在 DnD 操作期间,可能用户希望将操作目标放入一个可滚动的 GUI 控件区域中,而该区域当前对用户是不可见的。
DragGestureListener 此接口源于 DragGestureRecognizer,当该(子)类的对象检测到拖动启动动作时,调用此接口。
DragSourceListener DragSourceListener 定义了事件接口,Drag 和 Drop 操作的始发端使用它来跟踪用户操作的状态,并通过 Drag 和 Drop 操作为用户提供合适的“拖动结束”反馈。
DragSourceMotionListener 用于接收拖动操作期间鼠标移动事件的侦听器接口。
DropTargetListener DropTargetListener 接口是 DropTarget 类所使用的回调接口,用于提供所涉及的 DropTarget 的 DnD 操作的通知。
 

类摘要
DnDConstants 此类包含了表示 Drag 和 Drop 操作所执行的操作类型的常量值。
DragGestureEvent 当特定的 DragGestureRecognizer 检测到它正在跟踪的 Component 上已发生与平台相关的拖动启动动作时,将 DragGestureEvent 传递给 DragGestureListener 的 dragGestureRecognized() 方法。
DragGestureRecognizer DragGestureRecognizer 是一个针对与平台相关的侦听器规范的抽象基类,它可以与特定 Component 关联以标识与平台相关的拖动开始动作。
DragSource DragSource 是负责开始 Drag 和 Drop 操作的实体,可以用在如下场景中: JVM 生命周期中每个 JVM 的一个默认实例。
DragSourceAdapter 用于接收拖动源事件的抽象适配器类。
DragSourceContext DragSourceContext 类负责管理 Drag 和 Drop 协议的起始端。
DragSourceDragEvent 通过 DragSourceContext,将 DragSourceDragEventDragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListener DragSourceDragEvent 报告可反映当前拖动操作状态的目标放置动作用户放置动作
DragSourceDropEvent 通过 DragSourceContext,将 DragSourceDropEventDragSourceContextPeer 传递给向 DragSourceContext 及其关联 DragSource 注册的 DragSourceListenerdragDropEnd 方法。
DragSourceEvent 此类是 DragSourceDragEventDragSourceDropEvent 的基类。
DropTarget 在 Drag 和 Drop 操作期间,当 Component 希望接受 drop 时,DropTargetComponent 有关联。
DropTarget.DropTargetAutoScroller 此受保护的嵌套类实现自动滚动
DropTargetAdapter 接收放置目标事件的抽象适配器类。
DropTargetContext 每当与 Drag 和 Drop 操作相关的逻辑光标和与 DropTarget 相关的 Component 的可见几何结构重合时,就创建一个 DropTargetContext
DropTargetDragEvent 通过 dragEnter() 和 dragOver() 方法将 DropTargetDragEvent 发送给 DropTargetListener
DropTargetDropEvent 通过 DropTargetListener drop() 方法发送 DropTargetDropEvent
DropTargetEvent DropTargetEventDropTargetDragEventDropTargetDropEvent 的基类。
MouseDragGestureRecognizer DragGestureRecognizer 的抽象子类,它定义了一个基于鼠标动作的 DragGestureRecognizer
 

异常摘要
InvalidDnDOperationException java.awt.dnd 包中的各种方法都会抛出此异常。
 

软件包 java.awt.dnd 的描述

Drag 和 Drop 是一种直接操作操作,在许多图形用户界面系统中都会遇到它,它提供了一种机制,能够在两个与 GUI 中显示元素逻辑相关的实体之间传输信息。Drag 和 Drop 通常由使用适当输入设备的用户的实际操作所驱动,它既提供在对 GUI 显示元素导航期间启用连续反馈(关于传输给用户的任何后续数据的可能结果)的机制,又提供支持任何后续数据协商和传输的设施。

此包定义了在 Java 中执行 Drag 和 Drop 操作所需的类和接口。它定义了用于拖动源和放置目标的类,以及用于传输正被拖动的数据的事件。此包还在整个 Drag 和 Drop 操作期间提供一种向用户提供可视反馈的方法。

典型的 Drag 和 Drop 操作可以分解为以下几种状态(未完全按顺序):

该操作本身可以在整个 GUI 层次结构中移动逻辑光标,交叉 GUI 组件的几何图形,并可能导致逻辑“Drag”光标进入、跨越、随后离开 Component 及相关的 DropTarget

DragSource 对象向用户显示“Drag Over”反馈,一般情况下是通过激活与逻辑光标相关的 GUI Cursor 来实现的。

DropTarget 对象向用户显示“Drag Under”反馈,一般情况下是通过在 GUI Cursor 下将动画呈现到相关 GUI Component 来实现的。

反馈结果的确认、数据转换的最终成败(只发生一种)是按如下方式参数化的:

从以下版本开始:
1.2

JavaTM 2 Platform
Standard Ed. 5.0

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

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