Module  java.desktop
软件包  java.awt.dnd

Interface DragSourceListener

  • All Superinterfaces:
    EventListener
    所有已知实现类：
    DragSourceAdapter ， DragSourceContext 

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

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

    • 对应于该下降站点
    • 在此侦听器后面不会有一个dragExit()调用。
    从以下版本开始：
    1.2

    • 方法详细信息

      • 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