Provided by: manpages-zh_1.5.1-1_all bug

NAME
       selection - 操縱 X 選擇

` SYNOPSIS
       selection option ?arg arg ...?
_________________________________________________________________

yz DESCRIPTION
       這茤R令提供到      X     選擇機制的一     Tcl     接口並實現了在     X
       客戶間通信協定手冊(ICCCM)中描z全部選擇弁遄C

       給                          selection                           的第一-
       荌捊M定餘下的參數的格式和命令的行為。當前支持下列形式:

       selection clear ?-displayof window? ?-selection selection?
              如果      selection      存在於      window      的顯示器上的某-
              茼a方，則清除它這樣就沒有任何視窗擁有這蚇嚝雂F。Selection
              指定應該清除的   X   選擇，並且應當是一适子的名字如  PRIMARY  或
              CLIPBOARD；詳情請參見  X  客戶間通信協定手冊。Selection   預設為
              PRIMARY 而 window 預設為「.」。返回一茠臟瞗C

       selection get ?-displayof window? ?-selection selection? ?-type type?
              從        window        的顯示器取回        selection        的-
              癟漭戍@為結果返回。Selection   預設為   PRIMARY   而    window
              預設為「.」。Type    指定返回選擇用的形式(用   ICCCM   術語是想-
              n的轉換的「目標」)，並且應當是一适子的名字如      STRING      或
              FILE_NAME；   詳情請參見   X   客戶間通信協定手冊。Type   預設為
              STRING。選擇擁有者可以在多種不同的表示格式中挑選返回選擇(的格式)，比如
              STRING、ATOM、INTEGER 等。(這荇璁﹞ㄕP與選擇類型，如有混淆請參見
              ICCCM)。如果以非字符串格式返回選擇。比如       INTEGER        或
              ATOM，selection  命令把它轉換字符串格式，即一組用空格分隔的字段:
              把鴗l轉換成他怐漱憒r名字，把其他任何東西都轉換成十六進制整數。

       selection handle ?-selection selection? ?-type type?  ?-format  format?
       window command
              為選擇請求建立一茬B理器(handler)，這樣當 window  擁有  selection
              並且有人嘗試以用   type  (比方說在  selection  get  命令中指定了
              type)給出的形式取回它的時唌A則執行  command  。Selection  預設為
              PRIMARY，type   預設為STRING，而   format   預設為  STRING。如果
              command   是一茠臟瞗A則刪除針對   window、type   和    selection
              的所有處理器。

              在n求   selection  的時唌Awindow   是選擇的所有者，而  type  是-
              n求的類型，把 command  作為一  Tcl  稿本來執行，並向它添加了兩-
              虒犮R的數(帶有空格分隔符)。這兩虒犮R的數  是 offset 和 maxChars: |
              offset       指定在選擇中的開始位置而       maxChars       給出- |
              n取回的字符的最大數目。這茤R令應該返回一蚧，它由選擇的最多       |
              maxChars   字符組成，開始於位置    offset。對於非常大的選擇(大於 |
              maxChars)，使用遞增 offset 漲h次 command  調用來取回選擇。如果 |
              command   返回其長度小於   maxChars     的一茼r符串，則假定返回- |
              ]含選擇的全部餘下部分；如果  command 的結果的長度等於 maxChars |
              則將再次調用   command   ，知道最終返回小於    maxChars    的一- |
              茧痕G。maxChars 總是相對的大(成千茼r符)。

              如果 command 返回一蚇欞~，則丟棄取回的選擇，如同選擇根本不存在。

              format    參數指定用來把選擇傳輸(transmit)到請求者的表示法(ICCCM
              的表    2    的第二列)，並且預設為    STRING。如果   format   是
              STRING，則把選擇傳輸為  8-bit   ASCII   字符。如果   format   是
              ATOM，則把  data  分割為用白空格分隔的字段；把每茼r段轉換成它的-
              鴗lA傳輸 32-bit 鴗l茪ㄛO鴗l的名字。對於任何其他的 format，把
              data     分割為用白空格分隔的字段；把每茼r段轉換成一     32-bit
              整數；向選擇的請求者傳輸一蚞蒱獐捸C

              format  參數只在與不使用  Tk  的請求者相相容時需n。如果使用   Tk
              工具箱來取回      CLIPBOARD      選擇，則在請求端把這蚧轉換回一-
              茼r符串，所以 format 是無關的(irrelevant)。

       selection own ?-displayof window? ?-selection selection?

       selection own ?-command command? ?-selection selection? window
              第一種形式的      selection       own       返回在這蚗野峇云漱@-
              茧礸☆纁|名字的名字，這茧礸▽皉釵b容納    window    的顯示器上的
              selection，如果在這蚗野庥堥S有視窗擁有這蚇嚝傽N返回一-
              茠臟瞗CSelection    defaults  to  PRIMARY and window defaults to
              ``.''.

       selection  own  的第二種形式導P  window  成為在   window   的顯示器上的
       selection                                         的新擁有者，它返回一-
       茠臟磣@為結果。通知現存的擁有者(如果有的話)它已經失去了這-
       蚇嚝隉C如果指定了command，在其他一些視窗向     window    索取(claim)這-
       蚇嚝靰漫狾傅v的時唌A執行這紘cl 稿本。Selection 預設為 PRIMARY。

r KEYWORDS
       clear, format, handler, ICCCM, own, selection, target, type

[]
      Hhh

[]
       2002/05/27

m Linux manUpn:
       http://cmpp.linuxforum.net