JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
类 DropTargetContext

java.lang.Object
  继承者 java.awt.dnd.DropTargetContext
所有已实现的接口:
Serializable

public class DropTargetContext
extends Object
implements Serializable

每当与 Drag 和 Drop 操作相关的逻辑光标和与 DropTarget 相关的 Component 的可见几何结构重合时,就创建一个 DropTargetContextDropTargetContext 为放置操作的潜在接收者提供一种机制,该机制既为终端用户提供适当的拖动反馈,也影响适当的后续数据传输。

从以下版本开始:
1.2
另请参见:
序列化表格

嵌套类摘要
protected  class DropTargetContext.TransferableProxy
          TransferableProxy 是一个帮助器内部类,它实现 Transferable 接口,并用作另一个表示特定 drag-n-drop(拖放)操作数据转换的 Transferable 对象的代理。
 
方法摘要
protected  void acceptDrag(int dragOperation)
          接受该 Drag。
protected  void acceptDrop(int dropOperation)
          调用以指示放置操作是可接受的(使用指定的操作)。
 void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
          与 DropTargetContextPeer 关联时调用。
protected  Transferable createTransferableProxy(Transferable t, boolean local)
          创建一个代理指定 Transferable 的 TransferableProxy。
 void dropComplete(boolean success)
          此方法指示放置操作完成以及成功与否。
 Component getComponent()
          此方法返回与此 DropTargetContext 相关的 Component
protected  DataFlavor[] getCurrentDataFlavors()
          获得此操作的 Transferable 操作数的可用 DataFlavor。
protected  List<DataFlavor> getCurrentDataFlavorsAsList()
          此方法返回 Transferable 操作数当前可用的 DataFlavor,作为一个 java.util.List
 DropTarget getDropTarget()
          此方法返回与此 DropTargetContext 相关的 DropTarget
protected  int getTargetActions()
          此方法返回一个 int,表示 DropTarget 将接受的当前操作。
protected  Transferable getTransferable()
          获得此操作的 Transferable(代理)操作数
protected  boolean isDataFlavorSupported(DataFlavor df)
          此方法返回一个 boolean 值,指示给定的 DataFlavor 是否受此 DropTargetContext 支持。
protected  void rejectDrag()
          拒绝该 Drag。
protected  void rejectDrop()
          调用以指示放置操作是不可接受的。
 void removeNotify()
          取消与 DropTargetContextPeer 的关联时调用。
protected  void setTargetActions(int actions)
          此方法设置 DropTarget 可接受的当前操作。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

getDropTarget

public DropTarget getDropTarget()
此方法返回与此 DropTargetContext 相关的 DropTarget

返回:
与此 DropTargetContext 相关的 DropTarget

getComponent

public Component getComponent()
此方法返回与此 DropTargetContext 相关的 Component

返回:
与此 Context 相关的 Component

addNotify

public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
DropTargetContextPeer 关联时调用。

参数:
dtcp - DropTargetContextPeer

removeNotify

public void removeNotify()
取消与 DropTargetContextPeer 的关联时调用。


setTargetActions

protected void setTargetActions(int actions)
此方法设置 DropTarget 可接受的当前操作。

参数:
actions - 一个 int,表示受支持的操作

getTargetActions

protected int getTargetActions()
此方法返回一个 int,表示 DropTarget 将接受的当前操作。

返回:
DropTarget 可接受的当前操作

dropComplete

public void dropComplete(boolean success)
                  throws InvalidDnDOperationException
此方法指示放置操作完成以及成功与否。

参数:
success - 如果成功,则为 true;否则为 false

抛出:
InvalidDnDOperationException - 如果放置操作未完成/成功

acceptDrag

protected void acceptDrag(int dragOperation)
接受该 Drag。

参数:
dragOperation - 受支持的操作

rejectDrag

protected void rejectDrag()
拒绝该 Drag。


acceptDrop

protected void acceptDrop(int dropOperation)
调用以指示放置操作是可接受的(使用指定的操作)。在 DropTargetListener.drop 方法调用期间必须被调用。

参数:
dropOperation - 受支持的操作

rejectDrop

protected void rejectDrop()
调用以指示放置操作是不可接受的。在 DropTargetListener.drop 方法调用期间必须被调用。


getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()
获得此操作的 Transferable 操作数的可用 DataFlavor。

返回:
一个 DataFlavor[],它包含受支持的 Transferable 操作数的 DataFlavor

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()
此方法返回 Transferable 操作数当前可用的 DataFlavor,作为一个 java.util.List

返回:
当前可用的 DataFlavor,作为一个 java.util.List

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)
此方法返回一个 boolean 值,指示给定的 DataFlavor 是否受此 DropTargetContext 支持。

参数:
df - DataFlavor

返回:
指定的 DataFlavor 是否受支持

getTransferable

protected Transferable getTransferable()
                                throws InvalidDnDOperationException
获得此操作的 Transferable(代理)操作数

返回:
Transferable
抛出:
InvalidDnDOperationException - 如果放置操作未完成/成功


createTransferableProxy

protected Transferable createTransferableProxy(Transferable t,
                                               boolean local)
创建一个代理指定 Transferable 的 TransferableProxy。

参数:
t - 要被代理的 Transferable
local - 如果 t 表示本地 drag-n-drop 操作的结果,则为 true
返回:
新的 TransferableProxy 实例。

JavaTM 2 Platform
Standard Ed. 5.0

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

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