以 clipboard
对象的形式获取系统选择的一个实例。这使应用程序能够读取和修改当前系统范围内的选择。
无论用户在何时使用鼠标或键盘选择了文本,应用程序都要负责更新系统选择。通常,实现方式是在所有支持文本选择的 component
上,以及传递给该 component
的 focus_gained
和 focus_lost
事件之间安装一个 focuslistener
,并在 component
内的选择发生更改时更新系统选择 clipboard
。恰当地更新系统选择确保了 java 应用程序与本机应用程序和同时运行在系统上的其他 java 应用程序正确交互。注意,java.awt.textcomponent
和 javax.swing.text.jtextcomponent
已支持此策略。在使用这些类及其子类时,开发人员不需要编写任何额外的代码。
一些平台不支持系统选择 clipboard
。在这些平台上,此方法将返回 null
。在这种情况下,应用程序不再有责任更新系统选择 clipboard
(如上所述)。
此方法的每个实际实现都应该先检查是否安装了 securitymanager
。如果是安装了 securitymanager
,则应调用 securitymanager
的 checksystemclipboardaccess
方法,以确保可以访问系统剪贴板。如果使用 checksystemclipboardaccess
的默认实现(即如果未重写该方法),则将导致使用 awtpermission("accessclipboard")
权限调用 securitymanager
的 checkpermission
方法。
- 返回:
- 以
clipboard
形式返回系统选择,如果本机平台不支持系统选择 clipboard
,则返回 null
- 抛出:
headlessexception
- 如果 graphicsenvironment.isheadless() 返回 true- 从以下版本开始:
- 1.4
- 另请参见:
clipboard
,
focuslistener
,
focusevent.focus_gained
,
focusevent.focus_lost
,
textcomponent
,
jtextcomponent
,
awtpermission
,
graphicsenvironment.isheadless()