java.awt.datatransfer

接口
异常
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)
          创建能传输指定 StringTransferable
 
方法摘要
 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)
创建能传输指定 StringTransferable

方法详细信息

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()
返回 flavor 的数组, Transferable 可用该 flavor 提供数据。正确支持 DataFlavor.stringFlavor。对 DataFlavor.plainTextFlavor 的支持已被 废弃

指定者:
接口 Transferable 中的 getTransferDataFlavors
返回:
长度为 2 的数组,其元素为 DataFlavor. stringFlavorDataFlavor.plainTextFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)
返回所请求的 flavor 是否受此 Transferable 支持。

指定者:
接口 Transferable 中的 isDataFlavorSupported
参数:
flavor - 所请求的数据 flavor
返回:
如果 flavor 等于 DataFlavor.stringFlavorDataFlavor.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 - 此所有者置于剪贴板上的内容