selection(3tk) | Tk Built-In Commands | selection(3tk) |
selection - 操纵 X 选择
selection option ?arg arg ...?
这个命令提供到 X 选择机制的一个 Tcl 接口并实现了在 X 客户间通信协定手册(ICCCM)中描述全部选择功能。
给 selection 的第一个参数决定余下的参数的格式和命令的行为。当前支持下列形式:
在要求 selection 的时候,window 是选择的所有者,而 type 是要求的类型,把 command 作为一个 Tcl 脚本来执行,并向它添加了两个补充的数(带有空格分隔符)。这两个补充的数 是 offset 和 maxChars: offset 指定在选择中的开始位置而 maxChars 给出要取回的字符的最大数目。这个命令应该返回一个值,它由选择的最多 maxChars 字符组成,开始于位置 offset。对于非常大的选择(大于 maxChars),使用递增 offset 值的多次 command 调用来取回选择。如果 command 返回其长度小于 maxChars 的一个字符串,则假定返回值包含选择的全部余下部分;如果 command 的结果的长度等于 maxChars 则将再次调用 command ,知道最终返回小于 maxChars 的一个结果。maxChars 总是相对的大(成千个字符)。
如果 command 返回一个错误,则丢弃取回的选择,如同选择根本不存在。
format 参数指定用来把选择传输(transmit)到请求者的表示法(ICCCM 的表 2 的第二列),并且缺省为 STRING。如果 format 是 STRING,则把选择传输为 8-bit ASCII 字符。如果 format 是 ATOM,则把 data 分割为用白空格分隔的字段;把每个字段转换成它的原子值,传输 32-bit 原子值而不是原子的名字。对于任何其他的 format,把 data 分割为用白空格分隔的字段;把每个字段转换成一个 32-bit 整数;向选择的请求者传输一个整数的数组。
format 参数只在与不使用 Tk 的请求者相兼容时需要。如果使用 Tk 工具箱来取回 CLIPBOARD 选择,则在请求端把这个值转换回一个字符串,所以 format 是无关的(irrelevant)。
selection own 的第二种形式导致 window 成为在 window 的显示器上的 selection 的新拥有者,它返回一个空串作为结果。通知现存的拥有者(如果有的话)它已经失去了这个选择。如果指定了command,在其他一些窗口向 window 索取(claim)这个选择的所有权的时候,执行这个Tcl 脚本。Selection 缺省为 PRIMARY。
clear, format, handler, ICCCM, own, selection, target, type
寒蝉退士
2002/05/27
http://cmpp.linuxforum.net
本页面中文版由中文
man 手册页计划提供。
中文 man
手册页计划:https://github.com/man-pages-zh/manpages-zh
8.1 | Tk |