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

Class DropTargetAdapter

  • All Implemented Interfaces:
    DropTargetListener ， EventListener 

    public abstract class DropTargetAdapter
extends Object
implements DropTargetListener
    用于接收丢弃目标事件的抽象适配器类。 这个类中的方法是空的。 此类只能作为创建侦听器对象的方便。

    扩展此类以创建一个DropTargetEvent监听器，并覆盖感兴趣事件的方法。 （如果您实现了DropTargetListener接口，则必须定义其中的所有方法。此抽象类为除drop(DropTargetDropEvent)之外的每个方法定义了一个空实现，因此您只需定义关心的事件的方法。）您必须提供一个实施至少drop(DropTargetDropEvent) 。 此方法不能有空实现，因为它的规范要求您接受或拒绝该删除，并且如果接受，则指示该丢弃是否成功。

    使用扩展类创建一个侦听器对象，然后使用一个DropTarget注册它。 当拖动进入时，移动或退出DropTarget的拖放站点的可操作部分，当拖放操作发生变化时，发生丢弃时，将调用侦听器对象中的相关方法，并将DropTargetEvent传递给它。

    DropTarget的放置站点的可操作部分是相关联的Component的几何体的一部分，它不会被重叠的顶层窗口或另一个具有相关联的活动DropTarget的Z顺序的另一个Component所DropTarget 。

    在拖动期间，可以通过在传递给侦听器的方法的DropTargetDragEvent实例上调用getTransferable()来检索与当前拖动操作相关联的数据。

    请注意， getTransferable()实例上的DropTargetDragEvent应仅在相应侦听器的方法中调用，并且所有必需的数据应在返回的方法之前从返回的Transferable检索。

    从以下版本开始：
    1.4
    另请参见：
    DropTargetEvent ， DropTargetListener

    • 构造方法详细信息

      • DropTargetAdapter

        public DropTargetAdapter​()

    • 方法详细信息

      • dragEnter

        public void dragEnter​(DropTargetDragEvent dtde)
        当拖动操作正在进行时，当鼠标指针进入为此监听 DropTarget注册的 DropTarget站点的可操作部分时 DropTarget 。
        Specified by:
        dragEnter在接口 DropTargetListener
        参数
        dtde - DropTargetDragEvent

      • dragOver

        public void dragOver​(DropTargetDragEvent dtde)
        当拖动操作正在进行时被调用，而鼠标指针仍然 DropTarget在为此侦听 DropTarget注册的 DropTarget的放置站点的可操作部分。
        Specified by:
        dragOver在接口 DropTargetListener
        参数
        dtde - DropTargetDragEvent

      • dragExit

        public void dragExit​(DropTargetEvent dte)
        当拖动操作正在进行时，当鼠标指针已经退出了对此监听 DropTarget注册的 DropTarget的放置站点的可操作部分时 DropTarget 。
        Specified by:
        dragExit在接口 DropTargetListener
        参数
        dte - DropTargetEvent