| Dialog(3tk) | Dialog(3tk) |
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 手冊頁翻譯計劃》:
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃：https://github.com/man-pages-zh/manpages-zh
| tcllib - BWidget |