java.lang.Object
java.awt.datatransfer.Clipboard
实现使用剪切/复制/粘贴操作传输数据的机制的类。
FlavorListener
可以在剪贴板类的实例上注册,以便收到有关此剪贴板上可用的 DataFlavor
集的更改的通知(请参阅 addFlavorListener(java.awt.datatransfer.FlavorListener)
)。
- 自从:
- 1.1
- 参见:
-
字段摘要
字段 -
构造方法总结
构造方法 -
方法总结
修饰符和类型方法描述void
addFlavorListener
(FlavorListener listener) 注册指定的FlavorListener
以从此剪贴板接收FlavorEvent
s。返回一个DataFlavor
数组,其中可以提供此剪贴板的当前内容。getContents
(Object requestor) 返回表示剪贴板当前内容的可传输对象。getData
(DataFlavor flavor) 返回表示指定DataFlavor
中此剪贴板当前内容的对象。返回当前在此Clipboard
上注册的所有FlavorListener
的数组。getName()
返回此剪贴板对象的名称。boolean
isDataFlavorAvailable
(DataFlavor flavor) 返回是否可以在指定的DataFlavor
中提供此剪贴板的当前内容。void
removeFlavorListener
(FlavorListener listener) 删除指定的FlavorListener
以便它不再从这个Clipboard
接收FlavorEvent
s。void
setContents
(Transferable contents, ClipboardOwner owner) 将剪贴板的当前内容设置为指定的可传输对象,并将指定的剪贴板所有者注册为新内容的所有者。
-
字段详细信息
-
owner
剪贴板的所有者。 -
contents
剪贴板的内容。
-
-
构造方法详细信息
-
Clipboard
创建剪贴板对象。- 参数:
name
- 用于剪贴板- 参见:
-
-
方法详情
-
getName
返回此剪贴板对象的名称。- 返回:
- 此剪贴板对象的名称
- 参见:
-
setContents
将剪贴板的当前内容设置为指定的可传输对象,并将指定的剪贴板所有者注册为新内容的所有者。如果存在与参数
owner
不同的现有所有者,则通过对该所有者调用ClipboardOwner.lostOwnership()
通知该所有者它不再拥有剪贴板内容的所有权。setContents()
的实现可以自由地不直接从此方法调用lostOwnership()
。例如,lostOwnership()
稍后可能会在不同的线程上调用。这同样适用于在此剪贴板上注册的FlavorListener
s。如果剪贴板当前不可用,该方法将抛出
IllegalStateException
。例如,在某些平台上,系统剪贴板在被另一个应用程序访问时不可用。- 参数:
contents
- 表示剪贴板内容的可传输对象owner
- 拥有剪贴板内容的对象- 抛出:
IllegalStateException
- 如果剪贴板当前不可用- 参见:
-
getContents
返回表示剪贴板当前内容的可传输对象。如果剪贴板当前没有内容,则返回null
。当前未使用参数对象请求者。如果剪贴板当前不可用,该方法将抛出IllegalStateException
。例如,在某些平台上,系统剪贴板在被另一个应用程序访问时不可用。- 参数:
requestor
- 请求剪辑数据的对象(未使用)- 返回:
- 剪贴板上的当前可转移对象
- 抛出:
IllegalStateException
- 如果剪贴板当前不可用- 参见:
-
getAvailableDataFlavors
返回一个DataFlavor
数组,其中可以提供此剪贴板的当前内容。如果没有DataFlavor
可用,则此方法返回一个零长度数组。- 返回:
-
一个
DataFlavor
数组,其中可以提供此剪贴板的当前内容 - 抛出:
IllegalStateException
- 如果此剪贴板当前不可用- 自从:
- 1.5
-
isDataFlavorAvailable
返回是否可以在指定的DataFlavor
中提供此剪贴板的当前内容。- 参数:
flavor
- 请求的DataFlavor
内容- 返回:
true
如果可以在指定的DataFlavor
中提供此剪贴板的当前内容;false
否则- 抛出:
NullPointerException
- 如果flavor
是null
IllegalStateException
- 如果此剪贴板当前不可用- 自从:
- 1.5
-
getData
返回表示指定DataFlavor
中此剪贴板当前内容的对象。返回对象的类由flavor
的表示类定义。- 参数:
flavor
- 请求的DataFlavor
内容- 返回:
-
表示指定
DataFlavor
中此剪贴板当前内容的对象 - 抛出:
NullPointerException
- 如果flavor
是null
IllegalStateException
- 如果此剪贴板当前不可用UnsupportedFlavorException
- 如果请求的DataFlavor
不可用IOException
- 如果无法检索请求的DataFlavor
中的数据- 自从:
- 1.5
- 参见:
-
addFlavorListener
注册指定的FlavorListener
以从此剪贴板接收FlavorEvent
s。如果listener
是null
,则不会抛出异常并且不会执行任何操作。- 参数:
listener
- 要添加的监听器- 自从:
- 1.5
- 参见:
-
removeFlavorListener
删除指定的FlavorListener
以便它不再从这个Clipboard
接收FlavorEvent
s。如果先前未将参数指定的监听器添加到此Clipboard
,则此方法不执行任何功能,也不会引发异常。如果listener
是null
,则不会抛出异常并且不会执行任何操作。- 参数:
listener
- 要删除的监听器- 自从:
- 1.5
- 参见:
-
getFlavorListeners
返回当前在此Clipboard
上注册的所有FlavorListener
的数组。- 返回:
-
此剪贴板的所有
FlavorListener
s 或空数组(如果当前没有注册监听器) - 自从:
- 1.5
- 参见:
-