java.awt.datatransfer

Class Clipboard

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard
extends Object

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

FlavorListeners可注册对剪贴板的类的一个实例被通知更改这个剪贴板DataFlavors可用的设置（见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从剪贴板收到 FlavorEvents。
DataFlavor[]	getAvailableDataFlavors() 返回 DataFlavors这剪贴板的当前内容可以提供一个数组。
Transferable	getContents(Object requestor) 返回表示剪贴板的当前内容的可转移对象。
Object	getData(DataFlavor flavor) 返回表示在指定的 DataFlavor这个剪贴板的当前内容对象。
FlavorListener[]	getFlavorListeners() 返回所有的 FlavorListeners目前注册在这 Clipboard数组。
String	getName() 返回此剪贴板对象的名称。
boolean	isDataFlavorAvailable(DataFlavor flavor) 返回当前的内容是否该剪贴板可以在指定的 DataFlavor提供。
void	removeFlavorListener(FlavorListener listener) 移除指定的 FlavorListener使它不再接收 FlavorEvents从这 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

Field Detail

owner

protected ClipboardOwner owner

contents

protected Transferable contents

Constructor Detail

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()的实现是不从这个方法调用lostOwnership()直接。例如，lostOwnership()可以稍后在不同的线程调用。这同样适用于FlavorListeners这个剪贴板注册。

该方法将IllegalStateException如果剪贴板当前不可用。例如，在某些平台上，系统剪贴板是不可用的，而它是由另一个应用程序访问。

参数

contents代表剪贴板内容对象可转让

owner -对象拥有剪贴板内容

异常

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

另请参见：

Toolkit.getSystemClipboard()

getContents

public Transferable getContents(Object requestor)

返回表示剪贴板的当前内容的可转移对象。如果剪贴板中目前还没有内容，它返回 null。参数对象请求不使用。该方法将 IllegalStateException如果剪贴板当前不可用。例如，在某些平台上，系统剪贴板是不可用的，而它是由另一个应用程序访问。

参数

requestor -对象请求夹数据（未使用）

结果

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

异常

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

另请参见：

Toolkit.getSystemClipboard()

getAvailableDataFlavors

public DataFlavor[] getAvailableDataFlavors()

返回在这剪贴板的当前内容可以提供 DataFlavors数组。如果没有 DataFlavors可用，此方法返回一零数组长度。

结果

在这个剪贴板的当前内容可以提供 DataFlavors数组

异常

IllegalStateException如果剪贴板当前不可用

从以下版本开始：

一点五

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor flavor)

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

参数

flavor -请求的内容 DataFlavor

结果

如果这 true剪贴板的当前内容可以在指定的 DataFlavor提供； false否则

异常

如果是 null flavor NullPointerException

IllegalStateException如果剪贴板当前不可用

从以下版本开始：

一点五

getData

public Object getData(DataFlavor flavor)
               throws UnsupportedFlavorException,
                      IOException

返回表示在指定的 DataFlavor这个剪贴板的当前内容对象。返回的对象的类的类定义 flavor表示。

参数

flavor -请求的内容 DataFlavor

结果

表示在指定的 DataFlavor这个剪贴板的当前内容对象

异常

如果是 null flavor NullPointerException

IllegalStateException如果剪贴板当前不可用

UnsupportedFlavorException -如果要求 DataFlavor不可用

IOException -如果在要求的 DataFlavor数据无法检索

从以下版本开始：

一点五

另请参见：

DataFlavor.getRepresentationClass()

addFlavorListener

public void addFlavorListener(FlavorListener listener)

注册指定的 FlavorListener从剪贴板收到 FlavorEvents。如果 listener是 null，不引发异常，则不执行行动。

参数

listener -监听器被添加

从以下版本开始：

一点五

另请参见：

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

removeFlavorListener

public void removeFlavorListener(FlavorListener listener)

移除指定的 FlavorListener使它不再接收 FlavorEvents从这 Clipboard。这种方法不执行任何功能，也不抛出异常，如果由参数指定侦听器是以前没有加入这个 Clipboard。如果 listener是 null，不引发异常，则不执行行动。

参数

listener -听者被删除

从以下版本开始：

一点五

另请参见：

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

getFlavorListeners

public FlavorListener[] getFlavorListeners()

返回所有的 FlavorListeners目前注册在这 Clipboard数组。

结果

这一切的 FlavorListeners剪贴板或空数组如果没有听众正在注册

从以下版本开始：

一点五

另请参见：

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