Provided by: manpages-zh_1.5.2-1_all bug

NAME

       Dialog - 有定制按鈕的對話框

創建 CREATION
       Dialog pathName ?option value...?

描述 DESCRIPTION
       Dialog       組件使使用者能建立一個對話框。一些命令接受一個       index
       參數來指示在哪個 Button 上工作。這個索引與 ButtonBox 命令由相同的規定:

       number  用數值來指定  Button,這裏的  0  對應於第一個增加的   Button,1
       對應下一個,以此類推。

       endor 或 last 指示最後添加的項目。

       default 指示預設 Button。

組件特有選項 WIDGET-SPECIFIC OPTIONS
       -anchor (read-only)
              指定   ButtonBox  的定位點(anchor  point)。必須是  w、e、n、s、c
              之一。如果  side選項被設置為   top或   bottom,anchor值   n、s和
              c有相同的效果。如果   side選項被設置為   left或  right,anchor值
              w、e和 c有相同的效果。

       -bitmap (read-only)
              指定在使用者框架的左面顯示的一個位圖。image選項屏棄 bitmap。

       -cancel
              指定這個 Dialog 的取消按鈕的編號。當使用者在 Dialog  中按下  Esc
              的時候,調用這個按鈕。

       -default
              指定這個   Dialog   的預設按鈕的編號。當使用者在  Dialog  中按下
              Return 的時候,調用這個按鈕。

       -image (read-only)
              指定在使用者框架的左面顯示一個圖像。image選項屏棄 bitmap。

       -modal 這個選項必須是  none,  local或  global。這個選項的值指定對話框的
              grab 模式和如何完成 Dialog::draw。

       -parent
              這個                   Dialog                   的父視窗。Dialog
              在它的父視窗中居中。如果為空。則在根視窗中居中。

       -separator (read-only)
              指定在使用者框架和 ButtonBox 之間是否繪制一個分隔線。

       -side (read-only)
              指定在相對於使用者框架的何處繪制               ButtonBox。必須是
              top、left、bottom或 right 之一。

       -titleDialog
              頂層視窗的標題.

組件命令
       pathName add?arg...?
              向這個對話框的按鈕框增加一個按鈕。預設的     -command     選項是
              Dialog::enddialog $path index,這裏的 index是增加的按鈕的編號。

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

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

       pathName  draw?focus?   這個命令繪制   Dialog,並把   grab   設置為依從
       modal選項。如果                                         modal選項設置成
       none,則這個命令立即返回一個空串。在所有其他情況下,在調用
       Dialog::enddialog或銷毀       Dialog       的時候這個命令返回。返回值是
       Dialog::enddialog的 result參數,如果是被銷毀的則返回 -1。

              預設的把焦點設置到用                                     default
              選項引用的預設按鈕上,如果沒有設置預設按鈕則在            Dialog
              的頂層視窗上。如果                                         focus
              存在,則它必須是一個路徑名,或者是到一個按鈕的索引。最初的焦點被設置到這個路徑或對應的按鈕上。

       pathName enddialog  result
              典型的在按鈕的命令內調用這個命令來使 Dialog::draw 返回。

       pathName getframe
              返回這個使用者視窗的路徑名。

       pathName invoke index
              調用由 index 給出的按鈕。

       pathName itemcget index option
              返回這個項目的一個配置選項的當前值。Option
              可以是這個項目的建立命令能接受的任何值。

       pathName itemconfigure index ?option? ?value option value ...?
              這個命令類似於   configure  命令,但是它為單獨的項目提供選項,而
              configure                      為作為整體的組件提供選項。Options
              可以是項目建立組件命令可接受的任何值。如果指定了選項,則依據命令的指示修改選項並且命令返回一個空串。如果未指定選項,則返回描述這個項目的當前選項的一個列表。只讀選項不能修改。

       pathName setfocus index
              把焦點設置到用 index 給出的按鈕。

       pathName withdraw
              調用這個命令來隱藏這個對話框。

[中文版維護人]
       寒蟬退士

[中文版最新更新]
       2001/07/13

《中國 Linux 論壇 man 手冊頁翻譯計劃》:
       http://cmpp.linuxforum.net

                               tcllib - BWidget                    Dialog(3tk)