NAME

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

建立 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。

[中文版維護人]

       寒蟬退士

[中文版最新更新]

       2001/06/04

《中國 Linux 論壇 man 手冊頁翻譯計劃》:

       http://cmpp.linuxforum.net

跋

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

                                                tcllib - BWidget                                     Button(3tk)