模块  java.desktop
软件包  java.awt.dnd

Interface DragSourceListener

  • All Superinterfaces:
    EventListener
    所有已知实现类：
    DragSourceAdapter ， DragSourceContext 
    public interface DragSourceListenerextends EventListener
    DragSourceListener为拖放操作的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（）方法返回放置站点选择应用于Drop操作的操作。 此方法完成后，当前的DragSourceContext及相关资源将变为无效。
        参数
        dsde - the DragSourceDropEvent