Dialog(3tk) Dialog(3tk)

Dialog - 有定製按鈕的對話方塊

建立 CREATION

Dialog pathName ?option value...?

描述 DESCRIPTION

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

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

endor 或 last 指示最後新增的專案。

default 指示預設 Button。

元件特有選項 WIDGET-SPECIFIC OPTIONS

指定 ButtonBox 的定位點(anchor point)。必須是 w、e、n、s、c 之一。如果 side選項被設定為 top或 bottom，anchor值 n、s和 c有相同的效果。如果 side選項被設定為 left或 right，anchor值 w、e和 c有相同的效果。

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

指定這個 Dialog 的取消按鈕的編號。當用戶在 Dialog 中按下 Esc 的時候，呼叫這個按鈕。

指定這個 Dialog 的預設按鈕的編號。當用戶在 Dialog 中按下 Return 的時候，呼叫這個按鈕。

指定在使用者框架的左面顯示一個影象。image選項屏棄 bitmap。

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

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

指定在使用者框架和 ButtonBox 之間是否繪製一個分隔線。

指定在相對於使用者框架的何處繪製 ButtonBox。必須是 top、left、bottom或 right 之一。

頂層視窗的標題.

元件命令

向這個對話方塊的按鈕框增加一個按鈕。預設的 -command 選項是 Dialog::enddialog $path index，這裡的 index是增加的按鈕的編號。

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

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

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

典型的在按鈕的命令內呼叫這個命令來使 Dialog::draw 返回。

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

呼叫由 index 給出的按鈕。

返回這個專案的一個配置選項的當前值。Option 可以是這個專案的建立命令能接受的任何值。

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

把焦點設定到用 index 給出的按鈕。

呼叫這個命令來隱藏這個對話方塊。

寒蟬退士

2001/07/13

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

http://cmpp.linuxforum.net

跋

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

tcllib - BWidget