java.awt.dnd

Interface DropTargetListener

All Superinterfaces:

EventListener

所有已知实现类：

DropTarget， DropTargetAdapter

public interface DropTargetListener
extends EventListener

的 DropTargetListener接口由 DropTarget类用于提供对DND操作涉及课题 DropTarget通知回调接口。此接口的方法可以实现，以提供“在”视觉反馈给用户在整个拖放操作中的“拖动”。

通过实现接口，然后用DropTarget登记它创建一个侦听器的对象。当拖进来，移动，或退出，DropTarget滴现场操作的部分，在下降时的动作变化，当下降时，在监听对象相关的方法被调用时，与DropTargetEvent传递它。

为DropTarget滴现场操作部分的相关Component几何不重叠的顶层窗口或另一个Component高模糊的顺序，都有一个相关的活动DropTarget。

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

注意在DropTargetDragEvent实例getTransferable()只应各自在听者的方法称为和所有必要的数据应该是来自Transferable返回该方法返回前。

从以下版本开始：

一点二

方法摘要

Modifier and Type	Method and Description
void	dragEnter(DropTargetDragEvent dtde) 当拖动操作正在进行中，当鼠标指针进入注册的 DropTarget听众滴现场操作部分。
void	dragExit(DropTargetEvent dte) 当拖动操作正在进行中，当鼠标指针已经退出的 DropTarget注册听众滴现场操作部分。
void	dragOver(DropTargetDragEvent dtde) 当拖动操作正在进行中，当鼠标指针仍在为 DropTarget注册听众滴现场操作部分。
void	drop(DropTargetDropEvent dtde) 当拖动操作与对 DropTarget注册听众滴现场操作部分的下降终止。
void	dropActionChanged(DropTargetDragEvent dtde) 调用如果用户修改了当前的拖放手势。

方法详细信息

dragEnter

void dragEnter(DropTargetDragEvent dtde)

当拖动操作正在进行中，当鼠标指针进入注册的 DropTarget听众滴现场操作部分。

参数

dtde - DropTargetDragEvent

dragOver

void dragOver(DropTargetDragEvent dtde)

当拖动操作正在进行中，当鼠标指针仍在为 DropTarget注册听众滴现场操作部分。

参数

dtde - DropTargetDragEvent

dropActionChanged

void dropActionChanged(DropTargetDragEvent dtde)

调用如果用户修改了当前的拖放手势。

参数

dtde - DropTargetDragEvent

dragExit

void dragExit(DropTargetEvent dte)

当拖动操作正在进行中，当鼠标指针已经退出的 DropTarget注册听众滴现场操作部分。

参数

dte - DropTargetEvent

drop

void drop(DropTargetDropEvent dtde)

当拖动操作与对 DropTarget注册听众滴现场操作部分的下降终止。

此方法负责进行与手势相关联的数据的传输。的DropTargetDropEvent获得Transferable表示数据对象提供了一种手段（S）被转移。

从这个方法的DropTargetListener应当接受或拒绝放弃通过acceptdrop（int dropaction）或rejectdrop() DropTargetDropEvent参数的方法。

随后acceptdrop()，而不是之前，DropTargetDropEvent的gettransferable()方法会被调用，数据传输可以通过返回的Transferable的gettransferdata()方法进行。

在一个下降的完成，此方法的实现必须通过一个适当的boolean的DropTargetDropEvent的dropcomplete下拉的成功/失败的信号（布尔成功）的方法。

注：数据传输前要打电话给DropTargetDropEvent的dropcomplete完成（布尔成功）的方法。之后，调用该方法返回的gettransferdata() Transferable DropTargetDropEvent.getTransferable()保证只有当数据转移是局部的成功；那是，只有DropTargetDropEvent.isLocalTransfer()返回true。否则，调用的行为是依赖于实现的。

参数

dtde - DropTargetDropEvent