DropTargetListener (Java Platform SE 8 )

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	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对象的方法。
    
    从该方法中， 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 - the DropTargetDropEvent

Interface DropTargetListener

方法摘要

方法详细信息

dragEnter

dragOver

dropActionChanged

dragExit

drop