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 - 此所有者置于剪贴板上的内容