table of contents
other languages
- English tk8.5-doc
- English tk8.4-doc
- 中文 (zh-CN)
- 繁體中文 (zh-TW)
selection(3tk) | Tk Built-In Commands | selection(3tk) |
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 ``.''.
關鍵字 KEYWORDS¶
clear, format, handler, ICCCM, own, selection, target, type[中文版維護人]¶
寒蟬退士[中文版最新更新]¶
2002/05/27《中國 Linux 論壇 man 手冊頁翻譯計劃》:¶
http://cmpp.linuxforum.net8.1 | Tk |