Module java.datatransfer
Package java.awt.datatransfer

Class StringSelection

java.lang.Object
java.awt.datatransfer.StringSelection
所有已实现的接口:
ClipboardOwner, Transferable
public class StringSelection extends Object implements Transferable, ClipboardOwner
一个实现了可以传输String的Transferable。

这个Transferable正确支持DataFlavor.stringFlavor和所有等效的flavors。对DataFlavor.plainTextFlavor和所有等效的flavors的支持已被弃用。不支持其他DataFlavor。

自从:
1.1
参见:

  • Constructor Details

    • StringSelection

      public StringSelection(String data)
      创建一个能够传输指定String的Transferable。
      参数:
      data - 要传输的字符串

  • Method Details

    • getTransferDataFlavors

      public DataFlavor[] getTransferDataFlavors()
      返回一个数组，其中包含这个Transferable可以提供数据的flavors。DataFlavor.stringFlavor被正确支持。对DataFlavor.plainTextFlavor的支持已被弃用。
      指定者:
      getTransferDataFlavors 在接口 Transferable
      返回:
      一个长度为两的数组，其元素为DataFlavor.stringFlavor和DataFlavor.plainTextFlavor

    • isDataFlavorSupported

      public boolean isDataFlavorSupported(DataFlavor flavor)
      返回这个Transferable是否支持请求的flavor。
      指定者:
      isDataFlavorSupported 在接口 Transferable
      参数:
      flavor - 数据的请求flavor
      返回:
      如果flavor等于DataFlavor.stringFlavor或DataFlavor.plainTextFlavor，则返回true；如果flavor不是上述flavors之一，则返回false
      抛出:
      NullPointerException - 如果flavor为null

    • getTransferData

      public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException
      如果可能的话，返回这个Transferable的数据以请求的DataFlavor。如果所需的flavor是DataFlavor.stringFlavor或等效flavor，则返回表示选择的String。如果所需的flavor是DataFlavor.plainTextFlavor或等效flavor，则返回一个Reader。
      注意: 对于DataFlavor.plainTextFlavor和等效的DataFlavor，这个方法的行为与DataFlavor.plainTextFlavor的定义不一致。
      指定者:
      getTransferData 在接口 Transferable
      参数:
      flavor - 数据的请求flavor
      返回:
      请求的flavor中的数据，如上所述
      抛出:
      UnsupportedFlavorException - 如果请求的数据flavor不等同于DataFlavor.stringFlavor或DataFlavor.plainTextFlavor
      IOException - 如果在检索数据时发生IOException。默认情况下，StringSelection永远不会抛出此异常，但子类可能会抛出。
      NullPointerException - 如果flavor为null
      参见:

    • lostOwnership

      public void lostOwnership(Clipboard clipboard, Transferable contents)
      从接口中复制的描述: ClipboardOwner
      通知这个对象它不再是剪贴板所有者。当另一个应用程序或此应用程序中的另一个对象断言拥有剪贴板时，将调用此方法。
      指定者:
      lostOwnership 在接口 ClipboardOwner
      参数:
      clipboard - 不再拥有的剪贴板
      contents - 这个所有者放置在clipboard上的内容