模块 java.datatransfer
包 java.awt.datatransfer

类 Clipboard

java.lang.Object
java.awt.datatransfer.Clipboard
public class Clipboard extends Object
实现使用剪切/复制/粘贴操作传输数据的机制的类。

FlavorListener 可以在剪贴板类的实例上注册，以便收到有关此剪贴板上可用的 DataFlavor 集的更改的通知（请参阅 addFlavorListener(java.awt.datatransfer.FlavorListener) ）。

自从：
1.1
参见：

  • 字段详细信息

    • owner

      protected ClipboardOwner  owner
      剪贴板的所有者。

    • contents

      protected Transferable  contents
      剪贴板的内容。

  • 构造方法详细信息

  • 方法详情

    • getName

      public String  getName()
      返回此剪贴板对象的名称。
      返回：
      此剪贴板对象的名称
      参见：

    • setContents

      public void setContents(Transferable  contents, ClipboardOwner  owner)
      将剪贴板的当前内容设置为指定的可传输对象，并将指定的剪贴板所有者注册为新内容的所有者。

      如果存在与参数 owner 不同的现有所有者，则通过对该所有者调用 ClipboardOwner.lostOwnership() 通知该所有者它不再拥有剪贴板内容的所有权。 setContents() 的实现可以自由地不直接从此方法调用 lostOwnership()。例如，lostOwnership() 稍后可能会在不同的线程上调用。这同样适用于在此剪贴板上注册的FlavorListeners。

      如果剪贴板当前不可用，该方法将抛出 IllegalStateException。例如，在某些平台上，系统剪贴板在被另一个应用程序访问时不可用。

      参数：
      contents - 表示剪贴板内容的可传输对象
      owner - 拥有剪贴板内容的对象
      抛出：
      IllegalStateException - 如果剪贴板当前不可用
      参见：

    • getContents

      public Transferable  getContents(Object  requestor)
      返回表示剪贴板当前内容的可传输对象。如果剪贴板当前没有内容，则返回 null 。当前未使用参数对象请求者。如果剪贴板当前不可用，该方法将抛出 IllegalStateException。例如，在某些平台上，系统剪贴板在被另一个应用程序访问时不可用。
      参数：
      requestor - 请求剪辑数据的对象（未使用）
      返回：
      剪贴板上的当前可转移对象
      抛出：
      IllegalStateException - 如果剪贴板当前不可用
      参见：

    • getAvailableDataFlavors

      public DataFlavor [] getAvailableDataFlavors()
      返回一个 DataFlavor 数组，其中可以提供此剪贴板的当前内容。如果没有 DataFlavor 可用，则此方法返回一个零长度数组。
      返回：
      一个 DataFlavor 数组，其中可以提供此剪贴板的当前内容
      抛出：
      IllegalStateException - 如果此剪贴板当前不可用
      自从：
      1.5

    • isDataFlavorAvailable

      public boolean isDataFlavorAvailable(DataFlavor  flavor)
      返回是否可以在指定的 DataFlavor 中提供此剪贴板的当前内容。
      参数：
      flavor - 请求的 DataFlavor 内容
      返回：
      true 如果可以在指定的 DataFlavor 中提供此剪贴板的当前内容； false否则
      抛出：
      NullPointerException - 如果 flavor 是 null
      IllegalStateException - 如果此剪贴板当前不可用
      自从：
      1.5

    • getData

      public Object  getData(DataFlavor  flavor) throws UnsupportedFlavorException , IOException
      返回表示指定 DataFlavor 中此剪贴板当前内容的对象。返回对象的类由 flavor 的表示类定义。
      参数：
      flavor - 请求的 DataFlavor 内容
      返回：
      表示指定 DataFlavor 中此剪贴板当前内容的对象
      抛出：
      NullPointerException - 如果 flavor 是 null
      IllegalStateException - 如果此剪贴板当前不可用
      UnsupportedFlavorException - 如果请求的 DataFlavor 不可用
      IOException - 如果无法检索请求的 DataFlavor 中的数据
      自从：
      1.5
      参见：

    • addFlavorListener

      public void addFlavorListener(FlavorListener  listener)
      注册指定的 FlavorListener 以从此剪贴板接收 FlavorEvent s。如果 listener 是 null ，则不会抛出异常并且不会执行任何操作。
      参数：
      listener - 要添加的监听器
      自从：
      1.5
      参见：

    • removeFlavorListener

      public void removeFlavorListener(FlavorListener  listener)
      删除指定的 FlavorListener 以便它不再从这个 Clipboard 接收 FlavorEvent s。如果先前未将参数指定的监听器添加到此 Clipboard ，则此方法不执行任何功能，也不会引发异常。如果 listener 是 null ，则不会抛出异常并且不会执行任何操作。
      参数：
      listener - 要删除的监听器
      自从：
      1.5
      参见：

    • getFlavorListeners

      public FlavorListener [] getFlavorListeners()
      返回当前在此 Clipboard 上注册的所有 FlavorListener 的数组。
      返回：
      此剪贴板的所有 FlavorListener s 或空数组（如果当前没有注册监听器）
      自从：
      1.5
      参见：