Provided by: manpages-zh_1.6.3.3-2_all
NAME
selection - 操纵 X 选择
总览 SYNOPSIS
selection option ?arg arg ...? _________________________________________________________________
描述 DESCRIPTION
这个命令提供到 X 选择机制的一个 Tcl 接口并实现了在 X 客户间通信协定手册(ICCCM)中描述全部选择功能。 给 selection 的第一个参数决定余下的参数的格式和命令的行为。当前支持下列形式: selection clear ?-displayof window? ?-selection selection? 如果 selection 存在于 window 的显示器上的某个地方,则清除它这样就没有任何窗口拥有这个选择了。Selection 指定应该清除的 X 选择,并且应当是一个原子的名字如 PRIMARY 或 CLIPBOARD;详情请参见 X 客户间通信协定手册。Selection 缺省为 PRIMARY 而 window 缺省为“.”。返回一个空串。 selection get ?-displayof window? ?-selection selection? ?-type type? 从 window 的显示器取回 selection 的值并把它作为结果返回。Selection 缺省为 PRIMARY 而 window 缺省为“.”。Type 指定返回选择用的形式(用 ICCCM 术语是想要的转换的“目标”),并且应当是一个原子的名字如 STRING 或 FILE_NAME; 详情请参见 X 客户间通信协定手册。Type 缺省为 STRING。选择拥有者可以在多种不同的表示格式中挑选返回选择(的格式),比如 STRING、ATOM、INTEGER 等。(这个格式不同与选择类型,如有混淆请参见 ICCCM)。如果以非字符串格式返回选择。比如 INTEGER 或 ATOM,selection 命令把它转换字符串格式,即一组用空格分隔的字段: 把原子转换成他们的文字名字,把其他任何东西都转换成十六进制整数。 selection handle ?-selection selection? ?-type type? ?-format format? window command 为选择请求建立一个处理器(handler),这样当 window 拥有 selection 并且有人尝试以用 type (比方说在 selection get 命令中指定了 type)给出的形式取回它的时候,则执行 command 。Selection 缺省为 PRIMARY,type 缺省为STRING,而 format 缺省为 STRING。如果 command 是一个空串,则删除针对 window、type 和 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 ?-displayof window? ?-selection selection? selection own ?-command command? ?-selection selection? window 第一种形式的 selection own 返回在这个应用中的一个窗口路径名字的名字,这个窗口拥有在容纳 window 的显示器上的 selection,如果在这个应用种没有窗口拥有这个选择就返回一个空串。Selection defaults to PRIMARY and window defaults to ``.''. selection own 的第二种形式导致 window 成为在 window 的显示器上的 selection 的新拥有者,它返回一个空串作为结果。通知现存的拥有者(如果有的话)它已经失去了这个选择。如果指定了command,在其他一些窗口向 window 索取(claim)这个选择的所有权的时候,执行这个Tcl 脚本。Selection 缺省为 PRIMARY。
关键字 KEYWORDS
clear, format, handler, ICCCM, own, selection, target, type
[中文版维护人]
寒蝉退士
[中文版最新更新]
2002/05/27
《中国 Linux 论坛 man 手册页翻译计划》:
http://cmpp.linuxforum.net
跋
本页面中文版由中文 man 手册页计划提供。 中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh