java.awt.datatransfer

Class Clipboard

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard
extends Object

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

FlavorListener可能会在Clipboard类的实例上注册，以通知关于此剪贴板上可用的一组DataFlavor的更改（参见addFlavorListener(java.awt.datatransfer.FlavorListener) ）。

另请参见：

Toolkit.getSystemClipboard() ， Toolkit.getSystemSelection()

Field Summary

Fields

Modifier and Type	Field and Description
protected Transferable	contents
protected ClipboardOwner	owner

构造方法摘要

构造方法

Constructor and Description
Clipboard(String name) 创建剪贴板对象。

方法摘要

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

Methods inherited from class java.lang.Object

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

字段详细信息

owner

protected ClipboardOwner owner

contents

protected Transferable contents

构造方法详细信息

Clipboard

public Clipboard(String name)

创建剪贴板对象。

另请参见：

Toolkit.getSystemClipboard()

方法详细信息

getName

public String getName()

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

另请参见：

Toolkit.getSystemClipboard()

setContents

public void setContents(Transferable contents,
                        ClipboardOwner owner)

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

如果现有的所有者从参数不同owner ，该业主被告知不再通过的调用持有剪贴板内容的所有权ClipboardOwner.lostOwnership()上的主人。 setContents()的setContents()是免费的， lostOwnership()直接从这个方法调用lostOwnership() 。 例如， lostOwnership()可以稍后在不同的线程调用。 这同样适用于FlavorListener这个板子上注册秒。

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

参数

contents - 表示剪贴板内容的可转移对象

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

异常

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

另请参见：

Toolkit.getSystemClipboard()

getContents

public Transferable getContents(Object requestor)

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

参数

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

结果

剪贴板上的当前可转移对象

异常

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

另请参见：

Toolkit.getSystemClipboard()

getAvailableDataFlavors

public DataFlavor[] getAvailableDataFlavors()

返回一个DataFlavor的数组，其中可以提供此剪贴板的当前内容。 如果没有DataFlavor可用，则此方法返回零长度数组。

结果

一组 DataFlavor s，其中可以提供此剪贴板的当前内容

异常

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

从以下版本开始：

1.5

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor flavor)

返回是否此剪贴板的当前内容可以在指定的可提供 DataFlavor 。

参数

flavor - 所要求的 DataFlavor的内容

结果

true如果此剪贴板的当前内容可以在指定的DataFlavor中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以从此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 ，则此方法不执行任何功能，也不会抛出Clipboard 。 如果listener为null ，则不会抛出异常，也不执行任何操作。

参数

listener - 要删除的侦听器

从以下版本开始：

1.5

另请参见：

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

getFlavorListeners

public FlavorListener[] getFlavorListeners()

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

结果

所有这个剪贴板的 FlavorListener s或一个空数组，如果没有听众当前注册

从以下版本开始：

1.5

另请参见：

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