字段详细信息

• owner

  protected ClipboardOwner owner

  剪贴板的所有者。

• 目录

  protected Transferable contents

  剪贴板的内容。

构造方法详细信息

• Clipboard

  public Clipboard​(String name)

  创建剪贴板对象。

  参数

  name - 用于剪贴板

  另请参见：

  Toolkit.getSystemClipboard()

方法详细信息

• getName

  public String getName()

  返回此剪贴板对象的名称。

  结果

  此剪贴板对象的名称

  另请参见：

  Toolkit.getSystemClipboard()

• setContents

  public void setContents​(Transferable contents,
                          ClipboardOwner owner)

  将剪贴板的当前内容设置为指定的可传输对象，并将指定的剪贴板所有者注册为新内容的所有者。

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

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

  参数

  目录 - 表示剪贴板内容的可传输对象

  owner - 拥有剪贴板内容的对象

  异常

  IllegalStateException - 如果剪贴板当前不可用

  另请参见：

  Toolkit.getSystemClipboard()

• getContents

  public Transferable getContents​(Object requestor)

  返回表示剪贴板当前内容的可传输对象。 如果剪贴板当前没有内容，则返回null 。 当前未使用参数Object requestor。 如果剪贴板当前不可用，则该方法抛出IllegalStateException 。 例如，在某些平台上，系统剪贴板在其他应用程序访问时不可用。

  参数

  requestor - 请求剪辑数据的对象（未使用）

  结果

  剪贴板上当前可传输的对象

  异常

  IllegalStateException - 如果剪贴板当前不可用

  另请参见：

  Toolkit.getSystemClipboard()

• 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

  另请参见：

  DataFlavor.getRepresentationClass()

• addFlavorListener

  public void addFlavorListener​(FlavorListener listener)

  注册指定的FlavorListener以从此剪贴板接收FlavorEvent s。 如果listener是null ，则不会引发异常并且不执行任何操作。

  参数

  listener - 要添加的侦听器

  从以下版本开始：

  1.5

  另请参见：

  removeFlavorListener(java.awt.datatransfer.FlavorListener) ， getFlavorListeners() ， FlavorListener ， FlavorEvent

• removeFlavorListener

  public void removeFlavorListener​(FlavorListener listener)

  删除指定FlavorListener ，使其不再接收FlavorEvent从这个S Clipboard 。 如果先前未将参数指定的侦听器添加到此Clipboard ，则此方法不执行任何功能，也不会抛出异常。 如果listener是null ，则不会抛出任何异常并且不执行任何操作。

  参数

  listener - 要删除的侦听器

  从以下版本开始：

  1.5

  另请参见：

  addFlavorListener(java.awt.datatransfer.FlavorListener) ， getFlavorListeners() ， FlavorListener ， FlavorEvent

• getFlavorListeners

  public FlavorListener[] getFlavorListeners()

  返回当前在 Clipboard上注册的所有 FlavorListener的数组。

  结果

  所有这个剪贴板的 FlavorListener或如果当前没有注册侦听器的空数组

  从以下版本开始：

  1.5

  另请参见：

  addFlavorListener(java.awt.datatransfer.FlavorListener) ， removeFlavorListener(java.awt.datatransfer.FlavorListener) ， FlavorListener ， FlavorEvent