Provided by: manpages-zh_1.5.2-1.1_all bug

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)给出的形式取回它的时候,则执行
              commandSelection 缺省为 PRIMARY,type 缺省为STRING,而 format 缺省为  STRING。如
              果 command 是一个空串,则删除针对 windowtypeselection 的所有处理器。

              在要求  selection  的时候,window  是选择的所有者,而 type 是要求的类型,把 command
              作为一个  Tcl  脚本来执行,并向它添加了两个补充的数(带有空格分隔符)。这两个补充的数 │
              是  offsetmaxChars: 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