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

Class DragSourceAdapter

  • All Implemented Interfaces:
    DragSourceListener ， DragSourceMotionListener ， EventListener 

    public abstract class DragSourceAdapter
extends Object
implements DragSourceListener, DragSourceMotionListener
    用于接收拖动源事件的抽象适配器类。 这个类中的方法是空的。 此类只能作为创建侦听器对象的方便。

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

    使用扩展类创建一个侦听器对象，然后使用DragSource注册它。 当拖动进入，移过或退出一个放置点，放置操作改变时，并且当拖动结束，在收听对象中的相关方法被调用，并且DragSourceEvent被传递给它。

    落点与以前的相关dragEnter()如果最新调用调用 dragEnter()该适配器上对应于放置点，并没有跟随dragExit()调用该适配器上。

    从以下版本开始：
    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（）方法返回选择要应用于放置操作的放置站点的操作。 一旦这个方法完成，当前的DragSourceContext和相关的资源变得无效。
        Specified by:
        dragDropEnd在接口 DragSourceListener
        参数
        dsde - DragSourceDropEvent