当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

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

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.awt.dnd
接口 DragSourceListener

所有超级接口：

EventListener

所有已知实现类：

DragSourceAdapter, DragSourceContext

---

public interface DragSourceListener
extends EventListener

DragSourceListener 定义了事件接口，Drag 和 Drop 操作的始发端使用它来跟踪用户操作的状态，并通过 Drag 和 Drop 操作为用户提供合适的“拖动结束”反馈。

放置点是与上一次 dragEnter() 调用相关联 的，前提是在此侦听器上最后一次调用 dragEnter() 满足以下条件：

• 对应于该放置点，并且
• 随后没有在此侦听器上调用 dragExit()。

从以下版本开始：

1.2

---

方法摘要
void	dragDropEnd(DragSourceDropEvent dsde)           调用此方法来通知 Drag 和 Drop 操作已完成。
void	dragEnter(DragSourceDragEvent dsde)           光标的热点进入放置点（与平台相关）时调用该方法。
void	dragExit(DragSourceEvent dse)           光标的热点离开放置点（与平台相关）时调用该方法。
void	dragOver(DragSourceDragEvent dsde)           光标的热点在放置点（与平台相关）上移动时调用该方法。
void	dropActionChanged(DragSourceDragEvent dsde)           当用户修改放置操作时调用该方法。

 

方法详细信息

dragEnter

void dragEnter(DragSourceDragEvent dsde)

光标的热点进入放置点（与平台相关）时调用该方法。满足以下所有条件时调用此方法：

• 光标的热点进入与平台相关的放置点的可操作部分。
• 放置点处于激活状态。
• 放置点接受该拖动。

参数：

dsde - DragSourceDragEvent

---

dragOver

void dragOver(DragSourceDragEvent dsde)

光标的热点在放置点（与平台相关）上移动时调用该方法。满足以下所有条件时调用此方法：

• 光标的热点已移动，但是仍旧处于和上一次调用 dragEnter() 相关联的放置点可操作部分内。
• 放置点仍处于激活状态。
• 放置点接受该拖动。

参数：

dsde - DragSourceDragEvent

---

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

当用户修改放置操作时调用该方法。当用户使用的输入设备状态改变时调用此方法。这种设备通常是与用户交互的鼠标按键或键盘组合键。

参数：

dsde - DragSourceDragEvent

---

dragExit

void dragExit(DragSourceEvent dse)

光标的热点离开放置点（与平台相关）时调用该方法。满足以下任一条件时调用此方法：

• 光标的热点不再处于和上一次调用 dragEnter() 相关联的放置点可操作部分内。

或者

• 与上一次调用 dragEnter() 相关联的放置点不再处于激活状态。

或者

• 与上一次调用 dragEnter() 相关联的放置点拒绝该拖动。

参数：

dse - DragSourceEvent

---

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

调用此方法来通知 Drag 和 Drop 操作已完成。可以使用 DragSourceDropEvent 的 getDropSuccess() 方法来确定终止状态。放置点所选择的操作由 getDropAction() 方法返回，并应用到 Drop 操作中。一旦此方法完成，则当前的 DragSourceContext 和关联的资源就变为无效。

参数：

dsde - DragSourceDropEvent

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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