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

跋

       本页面中文版由中文 man 手册页计划提供。
       中文 man 手册页计划：https://github.com/man-pages-zh/manpages-zh

                                         tcllib - BWidget                             Dialog(3tk)