java.awt.datatransfer

Class StringSelection

java.lang.Object

java.awt.datatransfer.StringSelection

All Implemented Interfaces:

ClipboardOwner ， Transferable

public class StringSelection
extends Object
implements Transferable, ClipboardOwner

A Transferable ，其实现传送String所需的String 。 这Transferable正确支持DataFlavor.stringFlavor和所有相同的口味。 支持DataFlavor.plainTextFlavor和所有等效口味已被弃用 。 没有其他DataFlavor s的支持。

另请参见：

DataFlavor.stringFlavor ， DataFlavor.plainTextFlavor

构造方法摘要

构造方法

Constructor and Description
StringSelection(String data) 创建 Transferable能够转移指定的 String 。

方法摘要

Modifier and Type	Method and Description
Object	getTransferData(DataFlavor flavor) 如果可能，返回 Transferable的数据请求的 DataFlavor 。
DataFlavor[]	getTransferDataFlavors() 返回一个数组，其中可以提供这个数据的 Transferable 。
boolean	isDataFlavorSupported(DataFlavor flavor) 返回所请求的flavor是否受此支持 Transferable 。
void	lostOwnership(Clipboard clipboard, Transferable contents) 通知此对象不再是剪贴板所有者。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

StringSelection

public StringSelection(String data)

创建一个 Transferable能够传输指定的 String 。

方法详细信息

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

返回一个数组，其中这个Transferable可以提供Transferable 。 DataFlavor.stringFlavor被正确支持。 支持DataFlavor.plainTextFlavor已弃用 。

Specified by:

getTransferDataFlavors在界面 Transferable

结果

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

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

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

Specified by:

isDataFlavorSupported在界面 Transferable

参数

flavor - 数据所需的风味

结果

如果flavor等于DataFlavor.stringFlavor或DataFlavor.plainTextFlavor ; 如果flavor不是上述风味之一，则为false

异常

NullPointerException - 如果味道是 null

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException

如果可能，返回Transferable的数据请求DataFlavor 。 如果期望的味道是DataFlavor.stringFlavor或等同的风味，则返回String选择的String。 如果所需的味道是DataFlavor.plainTextFlavor或相当的风味，则返回Reader 。 注意： DataFlavor.plainTextFlavor和等效DataFlavor的此方法的行为与DataFlavor.plainTextFlavor的DataFlavor.plainTextFlavor 。

Specified by:

getTransferData在界面 Transferable

参数

flavor - 数据所需的风味

结果

请求的风味中的数据，如上所述

异常

UnsupportedFlavorException - 如果请求的数据风味不等于 DataFlavor.stringFlavor或 DataFlavor.plainTextFlavor

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

NullPointerException - 如果风味是 null

另请参见：

Reader

lostOwnership

public void lostOwnership(Clipboard clipboard,
                          Transferable contents)

说明从界面： ClipboardOwner复制

通知此对象不再是剪贴板所有者。 当该应用程序中的另一个应用程序或另一个对象断言剪贴板的所有权时，将调用此方法。

Specified by:

lostOwnership在界面 ClipboardOwner

参数

clipboard - 不再拥有的剪贴板

contents - 该主人放在剪贴板上的内容