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

Class DropTargetAdapter

  • 实现的所有接口
    DropTargetListener ， EventListener 
    public abstract class DropTargetAdapter
extends Object
implements DropTargetListener
    用于接收放置目标事件的抽象适配器类。 此类中的方法为空。 此类仅为创建侦听器对象而提供。

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

    使用扩展类创建一个侦听器对象，然后将其注册到DropTarget 。 当拖放动作发生变化时，拖动进入，移动或退出该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的放置站点的可操作部分时。
        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的放置站点的可操作部分时。
        Specified by:
        dragExit接口 DropTargetListener
        参数
        dte - DropTargetEvent