.TH Button 3tk "tcllib - BWidget"

.SH NAME
.B Button - 有增強選項的按鈕組件

.SH 創建 CREATION
.B Button pathName ?option value...?

.SH 描述 DESCRIPTION
Button 組件向 Tk 按鈕組件擴展了新選項。增加了動態幫助
(\fIDynamicHelp\fR) 選項，一個新面型(relief)式樣，arm/disarm 回調，和
repeatdelay/repeatinterval 選項。

.SH 組件特有選項 WIDGET-SPECIFIC OPTIONS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

.SH 組件命令

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

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

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

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

.SH "[中文版維護人]"
.B 寒蟬退士
.SH "[中文版最新更新]"
.B 2001/06/04
.SH "《中國 Linux 論壇 man 手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR