other languages
other sections
Dialog(3tk) | Dialog(3tk) |
NAME¶
Dialog - 有定制按鈕的對話框創建 CREATION¶
Dialog pathName ?option value...?描述 DESCRIPTION¶
Dialog 組件使使用者能建立一個對話框。一些命令接受一個 index 參數來指示在哪個 Button 上工作。這個索引與 ButtonBox 命令由相同的規定:組件特有選項 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。
-
- 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.nettcllib - BWidget |