当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

DropTargetContext (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		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 的可见几何结构重合时，就创建一个 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 实例。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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