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

Class 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)
        被称为光标的热点进入平台相关的放置站点。 满足以下所有条件时，将调用此方法：
        • 光标的热点进入平台相关的放置站点的可操作部分。
        • 放置站点处于活动状态。
        • 放置站点接受拖动。
        Specified by:
        dragEnter ，界面 DragSourceListener
        参数
        dsde - DragSourceDragEvent

      • dragOver

        public void dragOver​(DragSourceDragEvent dsde)
        被称为光标的热点在平台相关的放置站点上移动。 满足以下所有条件时，将调用此方法：
        • 光标的热点已移动，但仍与与先前dragEnter（）调用关联的放置站点的可操作部分相交。
        • 放置网站仍处于活动状态。
        • 放置站点接受拖动。
        Specified by:
        dragOver接口 DragSourceListener
        参数
        dsde - DragSourceDragEvent

      • dropActionChanged

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

      • dragExit

        public void dragExit​(DragSourceEvent dse)
        被称为光标的热点退出平台相关的放置站点。 满足以下任一条件时，将调用此方法：
        • 光标的热点不再与先前dragEnter（）调用关联的放置站点的可操作部分相交。
        要么
        • 与先前dragEnter（）调用关联的放置站点不再处于活动状态。
        要么
        • 与先前dragEnter（）调用关联的放置站点已拒绝拖动。
        Specified by:
        dragExit ，界面 DragSourceListener
        参数
        dse - DragSourceEvent

      • dragDropEnd

        public void dragDropEnd​(DragSourceDropEvent dsde)
        调用此方法表示拖放操作已完成。 所述的getDropSuccess（）方法DragSourceDropEvent可用于确定终止状态。 getDropAction（）方法返回放置站点选择应用于Drop操作的操作。 此方法完成后，当前的DragSourceContext及相关资源将变为无效。
        Specified by:
        dragDropEnd接口 DragSourceListener
        参数
        dsde - DragSourceDropEvent