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 |