Arch manual pages

Button(3tk) Button(3tk)

Button - 有增強選項的按鈕組件

Button pathName ?option value...?

Button 組件向 Tk 按鈕組件擴展了新選項。增加了動態幫助 (DynamicHelp) 選項,一個新面型(relief)式樣,arm/disarm 回調,和 repeatdelay/repeatinterval 選項。

-armcommand
指定當在 Button 上點擊鼠標按鈕 1 的時候與 Button 相關聯的一個 Tcl 命令。 在 repeatdelay 或 repeatinterval 選項是正整數的時候,如果鼠標指針在這個 按鈕之上,則反覆的調用這個命令,直到釋放鼠標按鈕 1。

-command
指定與 Button 相關聯的一個 Tcl 命令。典型的當鼠標按鈕 1 在 Button 窗口上 釋放的時候調用這個命令。

-default
指定缺省 ring 爲三種狀態之一: normal、active、或 disabled。在活躍狀態下 ,用這個平臺特定的缺省按鈕的外觀繪製這個按鈕。在普通狀態下,用這個平臺特 定的非缺省按鈕的外觀來繪製這個按鈕,留出足夠的空間來繪製缺省按鈕外觀。普 通和活躍狀態將導致相同大小的按鈕。在停用狀態下,用非缺省按鈕外觀來繪製這 個按鈕,但不爲缺省外觀留下空間。停用狀態將導致比活躍狀態更小的按鈕。

-disarmcommand
指定在鼠標按鈕 1 釋放的時候與 Button 相關聯的一個 Tcl 命令。即使鼠標指針 不在 Button 上也要調用這個命令,並且總是在用 command 選項指定的命令之前 。它典型的與 armcommand、repeatdelay 和 repeatinterval 聯合使用。

-height
爲 Button 指定想要的高度。如果在 Button 中顯示一個圖象或位圖,則這個值單 位是屏幕單位; 對於文本它以行爲單位。如果未指定這個選項,則從在其中顯示 的圖象或位圖或文本的大小來計算 Button 的需要的高度。

-helptext
動態幫助的文本。如果爲空,則這個組件不能獲得幫助。

-helptype
動態幫助的類型。使用 balloon 或 variable.

-helpvar
在 helptype 選項是 variable 的時候使用的變量。

-name
爲這個按鈕指定一個標準名字。如果在資源數據庫中找到選項 *nameName,則從它 的值中提取 text 和 underline 選項。

-relief
爲這個組件指定想要的 3-D 效果。可接受的值是按鈕面型(relief)的標準值 (raised、sunken、 flat、ridge、solid、和 groove) 和 link,它指定當指針在 按鈕外面的時候按鈕的面型是 flat 而在指針在裏面的時候是 raised。

-state
指定這個 Button 爲三種狀態之一: normal、active、或 disabled。在普通狀態 下,使用 foreground 和 background 選項顯示這個 Button。典型的在指針在這 個 Button 之上的時候使用活躍狀態。在活躍狀態下,使用 activeforeground 和 activebackground 選項顯示這個 Button。停用狀態意味着這個按鈕應當是沒有感 覺的(insensitive): 缺省綁定將拒絕激活這個組件並將忽略鼠標按扭按下。在這 種狀態下,使用 disabledforeground 和 background 選項顯示這個 Button。

-underline
指定在這個按鈕的標籤中要有下劃線的字符的整數索引。0 對應顯示的文本的第一 個字符,1 對應下一個字符,以此類推。

在這個按鈕的頂層窗口上自動把綁定 <Alt-char> 自動的設置爲調用 Button::setfocus。

-width
爲 Button 指定想要的寬度。如果在 Button 中顯示一個圖象或位圖,則這個值單 位是屏幕單位; 對於文本它以字符爲單位。如果未指定這個選項,則從在其中顯 示的圖象或位圖或文本的大小來計算 Button 的需要的寬度。

pathName cget option
返回用 option 給出的配置選項的當前值。Option 可以是能被建立命令接受的任何值。

pathName configure ?option? ?value option value ...?
查詢或修改這個組件的配置選項。如果未指定 option ,則返回描述 pathName 的 所有可獲得的選項的一個列表。如果指定了不帶 value 的 option,則這個命令返 回描述這個指名的 option 的一個列表(這個列表與未指定 option 所返回的值的 相應的子集是一樣的)。如果指定了一個或多個選項-值 對,則這個命令把給定的 組件選項修改爲給定的值;在這種情況下這個命令返回一個空串。Option 可以是 能被建立命令接受的任何值。只讀選項不可修改。

pathName invoke
如果 Button 的 state 不是停用。它調用這個按鈕的命令。用活躍顏色和 sunken 面型(relief)重新顯示 Button,並調用 armcommand。接着用普通顏色和它定義的 面型顯示 Button,並調用 disarmcommand 接着 command。

在 Button 獲得輸入聚焦並且用戶按 space bar 的時候調用 invoke。

寒蟬退士

2001/06/04

http://cmpp.linuxforum.net

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
tcllib - BWidget