java.awt.dnd

接口
异常
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 实例。