java.awt.dnd

Class DragSourceAdapter

java.lang.Object

java.awt.dnd.DragSourceAdapter

All Implemented Interfaces:

DragSourceListener ， DragSourceMotionListener ， EventListener

public abstract class DragSourceAdapter
extends Object
implements DragSourceListener, DragSourceMotionListener

用于接收拖动源事件的抽象适配器类。 这个类中的方法是空的。 此类只能作为创建侦听器对象的方便。

扩展此类以创建一个DragSourceEvent监听器并覆盖感兴趣的事件的方法。 （如果您实现DragSourceListener接口，则必须定义其中的所有方法。此抽象类为它们定义了空方法，因此您只需定义关心的事件的方法。）

使用扩展类创建一个侦听器对象，然后使用DragSource注册它。 当拖动操作发生变化时，当拖动进入，移动或退出拖放站点时，拖动结束时，将调用侦听器对象中的相关方法，并将DragSourceEvent传递给它。

落点与以前的相关dragEnter()如果最新调用调用 dragEnter()这个适配器上对应于放置点，而不是后面是dragExit()调用该适配器上。

从以下版本开始：

1.4

另请参见：

DragSourceEvent ， DragSourceListener ， DragSourceMotionListener

构造方法摘要

构造方法

Constructor and Description
DragSourceAdapter()

方法摘要

Modifier and Type	Method and Description
void	dragDropEnd(DragSourceDropEvent dsde) 调用此方法来表示拖放操作完成。
void	dragEnter(DragSourceDragEvent dsde) 称为光标的热点进入平台依赖的放置站点。
void	dragExit(DragSourceEvent dse) 称为光标的热点退出平台相关的放置站点。
void	dragMouseMoved(DragSourceDragEvent dsde) 在拖动操作期间鼠标移动时调用。
void	dragOver(DragSourceDragEvent dsde) 称为光标的热点在平台相关的放置站点上移动。
void	dropActionChanged(DragSourceDragEvent dsde) 当用户修改了放置手势时调用。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

DragSourceAdapter

public DragSourceAdapter()

方法详细信息

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

称为光标的热点进入平台依赖的放置站点。 当所有以下条件为真时，将调用此方法：

• 光标的热点进入平台依赖的放置站点的可操作部分。
• 投放站点处于活动状态。
• 拖放站点接受拖动。

Specified by:

dragEnter在界面 DragSourceListener

参数

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

称为光标的热点在平台相关的放置站点上移动。 当所有以下条件为真时，将调用此方法：

• 光标的热点已移动，但仍与与之前的dragEnter（）调用相关联的放置站点的可操作部分相交。
• 投放站点仍然活跃。
• 拖放站点接受拖动。

Specified by:

dragOver在界面 DragSourceListener

参数

dsde - DragSourceDragEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)

在拖动操作期间鼠标移动时调用。

Specified by:

dragMouseMoved在界面 DragSourceMotionListener

参数

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

当用户修改了放置手势时调用。 当用户正在交互的输入设备的状态发生变化时，将调用此方法。 这样的设备通常是用户正在交互的鼠标按钮或键盘修饰符。

Specified by:

dropActionChanged在界面 DragSourceListener

参数

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

称为光标的热点退出平台相关的放置站点。 当以下任一条件为真时，将调用此方法：

• 光标的热点不再与与之前的dragEnter（）调用相关联的放置站点的可操作部分相交。

要么

• 与之前的dragEnter（）调用相关联的丢弃站点不再处于活动状态。

要么

• 与之前的dragEnter（）调用相关联的丢弃站点已经拒绝了该拖动。

Specified by:

dragExit在界面 DragSourceListener

参数

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

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

Specified by:

dragDropEnd在界面 DragSourceListener

参数

dsde - DragSourceDropEvent