建立 CREATION
Button pathName ?option value...?
描述 DESCRIPTION
Button 元件向 Tk
按鈕元件擴充套件了新選項。增加了動態幫助
(DynamicHelp)
選項，一個新面型(relief)式樣，arm/disarm
回撥，和 repeatdelay/repeatinterval
選項。
元件特有選項 WIDGET-SPECIFIC
OPTIONS
- -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。
《中國 Linux 論壇 man
手冊頁翻譯計劃》:
http://cmpp.linuxforum.net
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃：https://github.com/man-pages-zh/manpages-zh