-
- All Superinterfaces:
-
EventListener
- 所有已知实现类:
-
DropTarget
,DropTargetAdapter
public interface DropTargetListener extends EventListener
DropTargetListener
接口是DropTarget
类使用的回调接口,用于提供涉及主题DropTarget
的DnD操作的通知。 可以实现该接口的方法,以在整个拖放操作中向用户提供“拖动”视觉反馈。通过实现接口创建一个监听器对象,然后使用
DropTarget
注册它。 当拖动进入时,移动或退出DropTarget
的拖放站点的可操作部分,当拖放操作发生变化时,当发生DropTarget
时,将调用侦听器对象中的相关方法,并将DropTargetEvent
传递给它。DropTarget
的下拉站点的可操作部分是相关联的Component
的几何体的一部分,它不被重叠的顶层窗口或另一个具有相关联的活动DropTarget
的Z顺序的另一个Component
DropTarget
。在拖动期间,与当前的拖动操作相关的数据可以通过调用来检索
getTransferable()
上DropTargetDragEvent
传递到听者的方法实例。请注意,
getTransferable()
实例上的DropTargetDragEvent
应该仅在相应的监听器方法中调用,并且所有必需的数据应该在该方法返回之前从返回的Transferable
检索。- 从以下版本开始:
- 1.2
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 void
dragEnter(DropTargetDragEvent dtde)
当拖动操作正在进行时,当鼠标指针进入为此监听DropTarget
注册的DropTarget
的放置站点的可操作部分时DropTarget
。void
dragExit(DropTargetEvent dte)
当拖动操作正在进行时,当鼠标指针已经退出了对此监听DropTarget
注册的DropTarget
站点的可操作部分时DropTarget
。void
dragOver(DropTargetDragEvent dtde)
当拖动操作正在进行时被调用,而鼠标指针仍然在为该监听DropTarget
注册的DropTarget
的放置站点的可操作部分上。void
drop(DropTargetDropEvent dtde)
当拖放操作终止时,拖放操作已被终止,而该拖放操作已在该监听DropTarget
注册的DropTarget
的丢弃站点的可操作部分上掉落。void
dropActionChanged(DropTargetDragEvent dtde)
如果用户修改了当前的放置手势,则被调用。
-
-
-
方法详细信息
-
dragEnter
void dragEnter(DropTargetDragEvent dtde)
当拖动操作正在进行时,当鼠标指针进入为此监听DropTarget
注册的DropTarget
的放置站点的可操作部分时DropTarget
。- 参数
-
dtde
-DropTargetDragEvent
-
dragOver
void dragOver(DropTargetDragEvent dtde)
当拖动操作正在进行时被调用,而鼠标指针仍然DropTarget
在为此侦听DropTarget
注册的DropTarget
的放置站点的可操作部分。- 参数
-
dtde
-DropTargetDragEvent
-
dropActionChanged
void dropActionChanged(DropTargetDragEvent dtde)
如果用户修改了当前的放置手势,则被调用。- 参数
-
dtde
-DropTargetDragEvent
-
dragExit
void dragExit(DropTargetEvent dte)
当拖动操作正在进行时,当鼠标指针已经退出了对此监听DropTarget
注册的DropTarget
的放置站点的可操作部分时DropTarget
。- 参数
-
dte
-DropTargetEvent
-
drop
void drop(DropTargetDropEvent dtde)
当拖放操作已终止时,在该监听DropTarget
注册的DropTarget
的可放置站点的可操作部分下降时DropTarget
。该方法负责进行与手势相关联的数据的传送。
DropTargetDropEvent
提供了一种获取表示要传输的数据对象的Transferable
对象的方法。通过这种方法,
DropTargetListener
将通过接受或拒绝该丢弃通过acceptDrop(int dropAction)或rejectDrop()方法的DropTargetDropEvent
参数。在acceptDrop()之后,但不在之前,可以调用
DropTargetDropEvent
的getTransferable()方法,并且可以通过返回的Transferable
的getTransferData()方法执行数据传输。在完成一个下降之后,需要执行此方法来通过将适当的
boolean
传递给DropTargetDropEvent
的dropComplete(布尔成功)方法来表示掉落的成功/失败。注意:在调用
DropTargetDropEvent
的dropComplete(boolean success)方法之前,应该完成数据传输。 之后,只有当数据传输是本地时,才能保证Transferable
返回的DropTargetDropEvent.getTransferable()
的getTransferData()方法的调用成功; 也就是说,只有DropTargetDropEvent.isLocalTransfer()
返回true
。 否则,呼叫的行为是依赖于实现的。- 参数
-
dtde
- theDropTargetDropEvent
-
-