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

StringSelection (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

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

---

java.awt.datatransfer
类 StringSelection

java.lang.Object
  java.awt.datatransfer.StringSelection

所有已实现的接口：

ClipboardOwner, Transferable

---

public class StringSelection
extends Object
implements Transferable, ClipboardOwner

实现传输 String 所需能力的 Transferable。此 Transferable 可以正确支持 DataFlavor.stringFlavor 及所有等效 flavor。对 DataFlavor.plainTextFlavor 及所有等效 flavor 的支持已被废弃。不支持其他 DataFlavor。

另请参见：

DataFlavor.stringFlavor, DataFlavor.plainTextFlavor

---

构造方法摘要
StringSelection(String data)           创建能传输指定 String 的 Transferable。

 

方法摘要
Object	getTransferData(DataFlavor flavor)           如果可能，则使用请求的 DataFlavor 返回 Transferable 的数据。
DataFlavor[]	getTransferDataFlavors()           返回 flavor 的数组，Transferable 可用该 flavor 提供数据。
boolean	isDataFlavorSupported(DataFlavor flavor)           返回所请求的 flavor 是否受此 Transferable 支持。
void	lostOwnership(Clipboard clipboard, Transferable contents)           通知此对象，它已不再是剪贴板所有者。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

StringSelection

public StringSelection(String data)

创建能传输指定 String 的 Transferable。

方法详细信息

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

返回 flavor 的数组，Transferable 可用该 flavor 提供数据。正确支持 DataFlavor.stringFlavor。对 DataFlavor.plainTextFlavor 的支持已被废弃。

指定者：

接口 Transferable 中的 getTransferDataFlavors

返回：

长度为 2 的数组，其元素为 DataFlavor. stringFlavor 和 DataFlavor.plainTextFlavor

---

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

返回所请求的 flavor 是否受此 Transferable 支持。

指定者：

接口 Transferable 中的 isDataFlavorSupported

参数：

flavor - 所请求的数据 flavor

返回：

如果 flavor 等于 DataFlavor.stringFlavor 或 DataFlavor.plainTextFlavor，则为 true；如果 flavor 不是上述两种 flavor 之一，则为 false

抛出：

NullPointerException - 如果 flavor 为 null

---

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException

如果可能，则使用请求的 DataFlavor 返回 Transferable 的数据。如果需要的 flavor 是 DataFlavor.stringFlavor 或其等效 flavor，则返回表示这一选择的 String。如果需要的 flavor 是 DataFlavor.plainTextFlavor 或其等效 flavor，则返回 Reader。注：针对 DataFlavor.plainTextFlavor 及其等效的 DataFlavor 的此方法的行为与 DataFlavor.plainTextFlavor 的定义不一致。

指定者：

接口 Transferable 中的 getTransferData

参数：

flavor - 请求的数据 flavor

返回：

按照上面的描述使用请求的 flavor 返回数据

抛出：

UnsupportedFlavorException - 如果请求的数据 flavor 既不等效于 DataFlavor.stringFlavor 也不等效于 DataFlavor.plainTextFlavor

IOException - 如果检索数据时发生 IOException。默认情况下，StringSelection 不会抛出此异常，但是其子类可以。

NullPointerException - 如果 flavor 为 null

另请参见：

Reader

---

lostOwnership

public void lostOwnership(Clipboard clipboard,
                          Transferable contents)

从接口 ClipboardOwner 复制的描述

通知此对象，它已不再是剪贴板所有者。当其他应用程序或此应用程序中的其他对象维护剪贴板的所有权时，调用此方法。

指定者：

接口 ClipboardOwner 中的 lostOwnership

参数：

clipboard - 不再拥有的剪贴板

contents - 此所有者置于剪贴板上的内容

---

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

---

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

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