Java java.awt.dnd 类 DragSourceAdapter（JDK5）

所有类

java.awt.dnd
类 DragSourceAdapter

java.lang.Object
  java.awt.dnd.DragSourceAdapter

所有已实现的接口：

DragSourceListener, DragSourceMotionListener, EventListener

public abstract class DragSourceAdapter
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements DragSourceListener, DragSourceMotionListener
   
   
   
   
   

用于接收拖动源事件的抽象适配器类。此类中的方法为空。此类存在的目的只是为了便于创建侦听器对象。

扩展此类即可创建 DragSourceEvent 侦听器并为感兴趣的事件重写该方法。（如果实现了 DragSourceListener 接口，则必须定义其中的所有方法。此抽象类为所有方法都定义了 null 方法，所以只需为关心的事件定义方法即可。）

使用扩展的类创建侦听器对象，然后向 DragSource 注册它。当拖动进入、移过或离开放置点时、放置操作改变时和拖动结束时，调用该侦听器对象中的相关方法，并将 DragSourceEvent 传递给该方法。

如果在此适配器类上最后一次调用 dragEnter() 是相对于该放置点的，并且后面没有接着在此适配器类上调用 dragExit()，则该放置点是与上一次 dragEnter() 调用相关联的。

从以下版本开始：

1.4

另请参见：

DragSourceEvent, DragSourceListener, DragSourceMotionListener

DragSourceAdapter

public DragSourceAdapter()

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

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

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

指定者：

接口 DragSourceListener 中的 dragEnter

参数：

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

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

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

指定者：

接口 DragSourceListener 中的 dragOver

参数：

dsde - DragSourceDragEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)

在拖动操作期间，只要移动了鼠标就调用该方法。

指定者：

接口 DragSourceMotionListener 中的 dragMouseMoved

参数：

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

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

指定者：

接口 DragSourceListener 中的 dropActionChanged

参数：

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

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

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

或者

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

或者

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

指定者：

接口 DragSourceListener 中的 dragExit

参数：

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

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

指定者：

接口 DragSourceListener 中的 dragDropEnd

参数：

dsde - DragSourceDropEvent