此类用于传输选取的文本。文本形式支持 DataFlavor.stringFlavor 及所有等效 flavor。
基本介绍
- 中文名：StringSelection类
- 外文名：StringSelection类
- 接口继承关係：java.lang.Object
- 另请参见：构造方法摘要
接口继承关係
java.awt.datatransfer类 StringSelection
java.lang.Object
java.awt.datatransfer.StringSelection
所有已实现的接口
ClipboardOwner, Transferablepublic class StringSelection extends Objectimplements 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 booleanisDataFlavorSupported(DataFlavor flavor)返回所请求的 flavor 是否受此 Transferable 支持。
指定者：接口 Transferable 中的 isDataFlavorSupported
参数：flavor - 所请求的数据 flavor
返回：如果 flavor 等于 DataFlavor.stringFlavor 或 DataFlavor.plainTextFlavor，则为 true；如果 flavor 不是上述两种 flavor 之一，则为 false
抛出：NullPointerException - 如果 flavor 为 null
getTransferData
public ObjectgetTransferData(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.plainTextFlavorIOException - 如果检索数据时发生 IOException。默认情况下，StringSelection 不会抛出此异常，但是其子类可以。 NullPointerException - 如果 flavor 为 null
另请参见：Reader
lostOwnership
public void lostOwnership(Clipboard clipboard, Transferable contents)
从接口ClipboardOwner 複製的描述通知此对象，它已不再是剪贴簿所有者。当其他应用程式或此应用程式中的其他对象维护剪贴簿的所有权时，调用此方法。
指定者：接口 ClipboardOwner 中的 lostOwnership
参数：clipboard - 不再拥有的剪贴簿 contents - 此所有者置于剪贴簿上的内容
