Module java.datatransfer

软件包 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所需的能力。

这Transferable正确支持DataFlavor.stringFlavor和所有相当的口味。 支持DataFlavor.plainTextFlavor和所有等同香料已被弃用 。 不支持其他DataFlavor 。

从以下版本开始：

1.1

另请参见：

DataFlavor.stringFlavor ， DataFlavor.plainTextFlavor

构造方法摘要

构造方法

Constructor	描述
StringSelection(String data)	创建 Transferable能够传送所述指定的 String 。

方法摘要

Modifier and Type	方法	描述
Object	getTransferData(DataFlavor flavor)	如果可能，返回请求的 DataFlavor中的 Transferable的数据。
DataFlavor[]	getTransferDataFlavors()	返回一个数组，其中这个 Transferable可以提供 Transferable 。
boolean	isDataFlavorSupported(DataFlavor 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 。

参数

data - 要传输的字符串

方法详细信息

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

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

Specified by:

getTransferDataFlavors在接口 Transferable

结果

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

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

返回此 Transferable是否支持请求的风格。

Specified by:

isDataFlavorSupported在接口 Transferable

参数

flavor - 数据所需的风味

结果

true如果flavor等于DataFlavor.stringFlavor或DataFlavor.plainTextFlavor ; false如果是flavor不是上述之一

异常

NullPointerException - 如果 flavor是 null

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException

返回Transferable所请求的数据DataFlavor如果可能的话。 如果所需的味道是DataFlavor.stringFlavor或等同的味道，则返回表示选择的String 。 如果所需的味道是DataFlavor.plainTextFlavor或相当的味道，则返回Reader 。
注意：此方法的行为DataFlavor.plainTextFlavor个等效DataFlavor S与定义不一致DataFlavor.plainTextFlavor 。

Specified by:

getTransferData在接口 Transferable

参数

flavor - 要求的数据风味

结果

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

异常

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

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

NullPointerException - 如果 flavor是 null

另请参见：

Reader

lostOwnership

public void lostOwnership(Clipboard clipboard,
                          Transferable contents)

说明从界面复制： ClipboardOwner

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

Specified by:

lostOwnership在接口 ClipboardOwner

参数

clipboard - 不再拥有的剪贴板

contents - 该业主放置在 clipboard