java.lang.Object java.awt.dnd.DropTargetAdapter
public abstract class DropTargetAdapter
接收放置目标事件的抽象适配器类。此类中的方法为空。此类存在的目的只是为了便于创建侦听器对象。
扩展此类即可创建 DropTargetEvent
侦听器并为感兴趣的事件重写该方法。(如果实现了 DropTargetListener
接口,则必须定义该接口内的所有方法。此抽象类为除 drop(DropTargetDropEvent)
以外的所有方法都定义了 null 实现,所以只需为关心的事件定义方法即可。)用户必须至少为 drop(DropTargetDropEvent)
提供一个实现。因为此方法的规范要求接受或拒绝放置,并且如果接受的话,要指出放置是否成功,所以此方法不能是 null 实现。
使用扩展的类创建侦听器对象,然后向 DropTarget
注册它。当拖动进入、移动或离开该 DropTarget
放置点的可操作部分时,以及放置操作改变时和放置发生时,调用该侦听器对象中的相关方法,并将 DropTargetEvent
传递给它。
DropTarget
放置点的可操作部分是关联 Component
的几何形状的一部分,该部分未被顶层窗口或另一个与活动 DropTarget
关联并且在 Z-order(排顺)中更高的 Component
所覆盖。
在拖动期间,可检索与当前拖动操作相关联的数据,方法是调用传递给侦听器方法的 DropTargetDragEvent
实例上的 getTransferable()
。
注意,应该只在各自侦听器方法内调用 DropTargetDragEvent
实例上的 getTransferable()
,并且应该在该方法返回前从返回的 Transferable
检索所有所需的数据。
DropTargetEvent
,
DropTargetListener
构造方法摘要 | |
---|---|
DropTargetAdapter() |
方法摘要 | |
---|---|
void |
dragEnter(DropTargetDragEvent dtde) 当鼠标指针进入向此侦听器注册的 DropTarget 放置点可操作部分时,则在拖动操作正在进行的同时调用该方法。 |
void |
dragExit(DropTargetEvent dte) 当鼠标指针已经离开向此侦听器注册的 DropTarget 放置点可操作部分时,则在拖动操作正在进行时调用该方法。 |
void |
dragOver(DropTargetDragEvent dtde) 当鼠标指针仍旧处于向此侦听器注册的 DropTarget 放置点可操作部分上时,则在拖动操作正在进行时调用该方法。 |
void |
dropActionChanged(DropTargetDragEvent dtde) 如果用户已经修改了当前的放置操作,则调用该方法。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
从接口 java.awt.dnd.DropTargetListener 继承的方法 |
---|
drop |
构造方法详细信息 |
---|
public DropTargetAdapter()
方法详细信息 |
---|
public void dragEnter(DropTargetDragEvent dtde)
DropTarget
放置点可操作部分时,则在拖动操作正在进行的同时调用该方法。
DropTargetListener
中的
dragEnter
dtde
-
DropTargetDragEvent
public void dragOver(DropTargetDragEvent dtde)
DropTarget
放置点可操作部分上时,则在拖动操作正在进行时调用该方法。
DropTargetListener
中的
dragOver
dtde
-
DropTargetDragEvent
public void dropActionChanged(DropTargetDragEvent dtde)
DropTargetListener
中的
dropActionChanged
dtde
-
DropTargetDragEvent
public void dragExit(DropTargetEvent dte)
DropTarget
放置点可操作部分时,则在拖动操作正在进行时调用该方法。
DropTargetListener
中的
dragExit
dte
-
DropTargetEvent