类 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 - 如果 flavornull
      IllegalStateException - 如果此剪贴板当前不可用
      自从:
      1.5
    • getData

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

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

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

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