table of contents
clipboard(3tk) | Tk Built-In Commands | clipboard(3tk) |
NAME¶
clipboard - 操纵 Tk 剪贴板
总览 SYNOPSIS¶
clipboard option ?arg arg ...?
描述 DESCRIPTION¶
这个命令提供了到 Tk 剪贴板的 Tcl 接口,它使用选择机制来为以后的取回存储数据。要把数据复制到剪贴板中,必须调用 clipboard clear,随后是到 clipboard append 的一个或多个调用的一个序列。要确保自动更新剪贴板,在返回到事件循环之前必须完成所有添加。
给 clipboard 的第一个参数决定剩余参数的格式和这个命令的行为。当前支持下列形式(form):
- clipboard clear ?-displayof window?
- 要求在 window 的显示器上剪贴板的所有权并删除所有以前的内容。Window 缺省为“.”。返回一个空串。
- clipboard append ?-displayof window? ?-format format? ?-type type? ?--? data
- 向在 window 的显示器上的剪贴板添加 data ,其形式由 type 给出,表示法(representation)由 format 给出,并且要求在 window 的显示器上剪贴板的所有权。
Type 参数指定返回的选择的形式(用 ICCCM 术语是想要的转换“目标”),并且应当是一个原子名字如 STRING 或 FILE_NAME;详情参见客户间通信协定手册。Type 缺省为 STRING。
format 参数指定用来把选择传输(transmit)到请求者的表示法(ICCCM 的表 2 的第二列),并且缺省为 STRING。如果 format 是 STRING,则把选择传输为 8-bit ASCII 字符。如果 format 是 ATOM,则把 data 分割为用白空格分隔的字段;把每个字段转换成它的原子值,传输 32-bit 原子值而不是原子的名字。对于任何其他的 format,把 data 分割为用白空格分隔的字段;把每个字段转换成一个 32-bit 整数;向选择的请求者传输一个整数的数组。注意在转换之前串联(concatenate)传递给 clipboard append 的字符串,所以调用者必须注意确保跨越字符串边界的间隔。添加到剪贴板的有相同 type 的所有项目必须有相同的 format。
format 参数只在与不使用 Tk 的请求者相兼容时需要。如果使用 Tk 工具箱来取回 CLIPBOARD 选择,则在请求端把这个值转换回一个字符串,所以 format 是无关的(irrelevant)。
-- 参数来标记选项的结束: 下一个参数总是被用做 data。在数据开始于 - 的时候这个特征会带来方便。
关键字 KEYWORDS¶
clear, format, clipboard, append, selection, type
[中文版维护人]¶
寒蝉退士
[中文版最新更新]¶
2001/05/17
《中国 Linux 论坛 man 手册页翻译计划》:¶
4.0 | Tk |