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() 满足以下条件:

从以下版本开始:
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)
光标的热点在放置点(与平台相关)上移动时调用该方法。满足以下所有条件时调用此方法:

参数:
dsde - DragSourceDragEvent

dropActionChanged

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

参数:
dsde - DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)
光标的热点离开放置点(与平台相关)时调用该方法。满足以下任一条件时调用此方法: 或者 或者

参数:
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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策