Question

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(Stringdata) 创建能传输指定 String 的 Transferable 。

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

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

构造方法详细信息

StringSelection

public StringSelection(Stringdata)

创建能传输指定 String 的 Transferable 。

方法详细信息

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

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

指定者：

接口 Transferable 中的 getTransferDataFlavors

返回：

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

---

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavorflavor)

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

指定者：

接口 Transferable 中的 isDataFlavorSupported

参数：

flavor - 所请求的数据 flavor

返回：

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

抛出：

NullPointerException - 如果 flavor 为 null

---

getTransferData

public Object getTransferData(DataFlavorflavor)
                       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(Clipboardclipboard,
                          Transferablecontents)

从接口 ClipboardOwner 复制的描述

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

指定者：

接口 ClipboardOwner 中的 lostOwnership

参数：

clipboard - 不再拥有的剪贴板

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