java.awt.dnd

Interface DragSourceListener

All Superinterfaces:

EventListener

所有已知实现类：

DragSourceAdapter ， DragSourceContext

public interface DragSourceListener
extends EventListener

DragSourceListener定义了用于跟踪用户手势状态的拖放操作的DragSourceListener的事件接口，并在拖放操作中向用户提供适当的“拖拽”反馈。

如果最近在此侦听器上dragEnter() dragEnter()，则该丢弃站点与之前的dragEnter()调用相关dragEnter() ：

• 对应于该下降站点
• 在此侦听器之后不会dragExit() dragExit()。

从以下版本开始：

1.2

方法摘要

Modifier and Type	Method and Description
void	dragDropEnd(DragSourceDropEvent dsde) 调用此方法来表示拖放操作完成。
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)

调用此方法来表示拖放操作完成。 所述的getDropSuccess（）方法DragSourceDropEvent可用于确定终止状态。 getDropAction（）方法返回选择要应用于放置操作的放置站点的操作。 一旦这个方法完成，当前的DragSourceContext和相关的资源变得无效。

参数

dsde - the DragSourceDropEvent