JavaTM 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
 

构造方法详细信息

DropTargetAdapter

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策