java.awt.dnd
类 DropTargetContext

java.lang.Object
  java.awt.dnd.DropTargetContext

所有已实现的接口：

Serializable

public class DropTargetContext
extends Object
implements Serializable

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

从以下版本开始：

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 实例。