DropTargetContext

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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
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 实例。

概述