以 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()