模块 java.datatransfer

软件包 java.awt.datatransfer

Class Clipboard

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard
extends Object

实现使用剪切/复制/粘贴操作传输数据的机制的类。

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

从以下版本开始：

1.1

另请参见：

Toolkit.getSystemClipboard() ， Toolkit.getSystemSelection()

字段汇总

字段

变量和类型	字段	描述
protected Transferable	目录	剪贴板的内容。
protected ClipboardOwner	owner	剪贴板的所有者。

构造方法摘要

构造方法

构造器	描述
Clipboard(String name)	创建剪贴板对象。

方法摘要

变量和类型	方法	描述
void	addFlavorListener(FlavorListener listener)	注册指定的 FlavorListener以从此剪贴板接收 FlavorEvent 。
DataFlavor[]	getAvailableDataFlavors()	返回一个 DataFlavor的数组，其中可以提供此剪贴板的当前内容。
Transferable	getContents(Object requestor)	返回表示剪贴板当前内容的可传输对象。
Object	getData(DataFlavor flavor)	返回一个对象，该对象表示指定的 DataFlavor中此剪贴板的当前内容。
FlavorListener[]	getFlavorListeners()	返回当前在 Clipboard上注册的所有 FlavorListener的数组。
String	getName()	返回此剪贴板对象的名称。
boolean	isDataFlavorAvailable(DataFlavor flavor)	返回是否可以在指定的 DataFlavor提供此剪贴板的当前内容。
void	removeFlavorListener(FlavorListener listener)	删除指定的 FlavorListener ，使其不再从此 Clipboard收到 FlavorEvent s。
void	setContents(Transferable contents, ClipboardOwner owner)	将剪贴板的当前内容设置为指定的可传输对象，并将指定的剪贴板所有者注册为新内容的所有者。

声明方法的类 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

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