Module java.desktop
Package java.awt.dnd

Class DragSourceAdapter

java.lang.Object
java.awt.dnd.DragSourceAdapter
所有已实现的接口:
DragSourceListener, DragSourceMotionListener, EventListener
public abstract class DragSourceAdapter extends Object implements DragSourceListener, DragSourceMotionListener
用于接收拖动源事件的抽象适配器类。此类中的方法为空。此类仅作为创建监听器对象的便利。

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

使用扩展类创建监听器对象，然后将其注册到DragSource。当拖动进入、移动或退出放置点时，当放置操作更改时，以及当拖动结束时，将调用监听器对象中的相关方法，并将DragSourceEvent传递给它。

如果最新对此适配器的dragEnter()调用对应于该放置点，并且未跟随此适配器上的dragExit()调用，则放置点与之前的dragEnter()调用相关联。

自从:
1.4
参见:

  • Constructor Details

    • DragSourceAdapter

      protected DragSourceAdapter()
      构造一个DragSourceAdapter。

  • Method Details

    • dragEnter

      public void dragEnter(DragSourceDragEvent dsde)
      当光标的热点进入特定于平台的放置点时调用。当以下所有条件为真时，将调用此方法：
      • 光标的热点进入特定于平台的放置点的可操作部分。
      • 放置点处于活动状态。
      • 放置点接受拖动。
      指定者:
      dragEnter 在接口 DragSourceListener中
      参数:
      dsde - DragSourceDragEvent

    • dragOver

      public void dragOver(DragSourceDragEvent dsde)
      当光标的热点移动到特定于平台的放置点上时调用。当以下所有条件为真时，将调用此方法：
      • 光标的热点已移动，但仍与与之前的dragEnter()调用相关联的放置点的可操作部分相交。
      • 放置点仍处于活动状态。
      • 放置点接受拖动。
      指定者:
      dragOver 在接口 DragSourceListener中
      参数:
      dsde - DragSourceDragEvent

    • dragMouseMoved

      public void dragMouseMoved(DragSourceDragEvent dsde)
      在拖动操作期间鼠标移动时调用。
      指定者:
      dragMouseMoved 在接口 DragSourceMotionListener中
      参数:
      dsde - DragSourceDragEvent

    • dropActionChanged

      public void dropActionChanged(DragSourceDragEvent dsde)
      当用户修改放置手势时调用。当用户交互的输入设备的状态发生变化时，将调用此方法。这些设备通常是用户正在交互的鼠标按钮或键盘修改器。
      指定者:
      dropActionChanged 在接口 DragSourceListener中
      参数:
      dsde - DragSourceDragEvent

    • dragExit

      public void dragExit(DragSourceEvent dse)
      当光标的热点退出特定于平台的放置点时调用。当以下任一条件为真时，将调用此方法：
      • 光标的热点不再与与之前的dragEnter()调用相关联的放置点的可操作部分相交。
      或
      • 与之前的dragEnter()调用相关联的放置点不再处于活动状态。
      或
      • 与之前的dragEnter()调用相关联的放置点已拒绝拖动。
      指定者:
      dragExit 在接口 DragSourceListener中
      参数:
      dse - DragSourceEvent

    • dragDropEnd

      public void dragDropEnd(DragSourceDropEvent dsde)
      调用此方法表示拖放操作已完成。可以使用DragSourceDropEvent的getDropSuccess()方法确定终止状态。getDropAction()方法返回放置点选择应用于拖放操作的操作。一旦完成此方法，当前的DragSourceContext和相关资源将变为无效。
      指定者:
      dragDropEnd 在接口 DragSourceListener中
      参数:
      dsde - DragSourceDropEvent