Module java.desktop
Package java.awt.dnd

Interface DragSourceListener

所有超接口:
EventListener
所有已知实现类:
DragSourceAdapter, DragSourceContext
public interface DragSourceListener extends EventListener
DragSourceListener 定义了拖放操作发起者的事件接口，用于跟踪用户手势的状态，并在整个拖放操作过程中向用户提供适当的“拖放过程中”反馈。

如果此监听器上 dragEnter() 的最新调用：

  • 对应于该放置点，并且
  • 没有在此监听器上跟随 dragExit() 的调用。
自版本:
1.2

  • Method Details

    • 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)
      此方法被调用以表示拖放操作已完成。可以使用 DragSourceDropEvent 的 getDropSuccess() 方法来确定终止状态。getDropAction() 方法返回放置点选择应用于拖放操作的操作。一旦此方法完成，当前的 DragSourceContext 和相关资源将变为无效。
      参数:
      dsde - DragSourceDropEvent