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

Class DragSourceAdapter

  • All Implemented Interfaces:
    DragSourceListenerDragSourceMotionListenerEventListener


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

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

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

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

    从以下版本开始:
    1.4
    另请参见:
    DragSourceEventDragSourceListenerDragSourceMotionListener
    • 构造方法详细信息

      • 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