DropTargetAdapter

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.dnd
类 DropTargetAdapter

java.lang.Object
  java.awt.dnd.DropTargetAdapter

所有已实现的接口：: DropTargetListener, EventListener

public abstract class DropTargetAdapter
extends Object
implements DropTargetListener

接收放置目标事件的抽象适配器类。此类中的方法为空。此类存在的目的只是为了便于创建侦听器对象。

扩展此类即可创建 DropTargetEvent 侦听器并为感兴趣的事件重写该方法。（如果实现了 DropTargetListener 接口，则必须定义该接口内的所有方法。此抽象类为除 drop(DropTargetDropEvent) 以外的所有方法都定义了 null 实现，所以只需为关心的事件定义方法即可。）用户必须至少为 drop(DropTargetDropEvent) 提供一个实现。因为此方法的规范要求接受或拒绝放置，并且如果接受的话，要指出放置是否成功，所以此方法不能是 null 实现。

使用扩展的类创建侦听器对象，然后向 DropTarget 注册它。当拖动进入、移动或离开该 DropTarget 放置点的可操作部分时，以及放置操作改变时和放置发生时，调用该侦听器对象中的相关方法，并将 DropTargetEvent 传递给它。

DropTarget 放置点的可操作部分是关联 Component 的几何形状的一部分，该部分未被顶层窗口或另一个与活动 DropTarget 关联并且在 Z-order（排顺）中更高的 Component 所覆盖。

在拖动期间，可检索与当前拖动操作相关联的数据，方法是调用传递给侦听器方法的 DropTargetDragEvent 实例上的 getTransferable()。

注意，应该只在各自侦听器方法内调用 DropTargetDragEvent 实例上的 getTransferable()，并且应该在该方法返回前从返回的 Transferable 检索所有所需的数据。

从以下版本开始：: 1.4
另请参见：: 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()

方法详细信息

dragEnter

public void dragEnter(DropTargetDragEvent dtde)

当鼠标指针进入向此侦听器注册的 DropTarget 放置点可操作部分时，则在拖动操作正在进行的同时调用该方法。

指定者：: 接口 DropTargetListener 中的 dragEnter

参数：: dtde - DropTargetDragEvent

dragOver

public void dragOver(DropTargetDragEvent dtde)

当鼠标指针仍旧处于向此侦听器注册的 DropTarget 放置点可操作部分上时，则在拖动操作正在进行时调用该方法。

指定者：: 接口 DropTargetListener 中的 dragOver

参数：: dtde - DropTargetDragEvent

dropActionChanged

public void dropActionChanged(DropTargetDragEvent dtde)

如果用户已经修改了当前的放置操作，则调用该方法。

指定者：: 接口 DropTargetListener 中的 dropActionChanged

参数：: dtde - DropTargetDragEvent

dragExit

public void dragExit(DropTargetEvent dte)

当鼠标指针已经离开向此侦听器注册的 DropTarget 放置点可操作部分时，则在拖动操作正在进行时调用该方法。

指定者：: 接口 DropTargetListener 中的 dragExit

参数：: dte - DropTargetEvent

概述