[incr Widgets] - dialog manpage





NAME

       dialog - Create and manipulate a dialog widget


SYNOPSIS

       dialog pathName ?options?


INHERITANCE

       itk::Toplevel <- Shell <- Dialogshell <- Dialog


STANDARD OPTIONS

       background      cursor         foreground

       See the "options" manual entry for details on the standard
       options.


INHERITED OPTIONS

       buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
       padY            separator      thickness

       See the "dialogshell" manual  entry  for  details  on  the
       above inherited options.

       height          master         modality        width

       See  the  "shell"  manual  entry  for details on the above
       inherited options.

       title

       See the "Toplevel" manual entry for details on  the  above
       inherited options.
_________________________________________________________________



DESCRIPTION

       The dialog command creates a dialog box providing standard
       buttons and a child site for use in derived classes.   The
       buttons  include ok, apply, cancel, and help.  Methods and
       Options exist to configure the buttons and their  contain­
       ing box.



METHODS

       The dialog command creates a new Tcl command whose name is
       pathName.  This command may  be  used  to  invoke  various
       operations  on  the  widget.  It has the following general
       form:

              pathName option ?arg arg ...?

       Option and the args determine the exact  behavior  of  the


INHERITED METHODS

       add             buttonconfigure                defaulthide
       index           insert         invoke          show

       See the "buttonbox" manual entry for details on the  above
       inherited methods.

       childsite

       See  the  "dialogshell"  manual  entry  for details on the
       above inherited methods.

       activate        center         deactivate

       See the "shell" manual entry  for  details  on  the  above
       inherited methods.



WIDGET-SPECIFIC METHODS

       pathName cget option
              Returns  the  current  value  of  the configuration
              option given by option.  Option may have any of the
              values accepted by the dialog command.

       pathName configure ?option? ?value option value ...?
              Query  or  modify  the configuration options of the
              widget.  If no option is specified, returns a  list
              describing  all  of the available options for path­
              Name (see Tk_ConfigureInfo for information  on  the
              format  of this list).  If option is specified with
              no value, then the command returns a list  describ­
              ing the one named option (this list will be identi­
              cal to  the  corresponding  sublist  of  the  value
              returned  if  no  option  is specified).  If one or
              more option-value pairs  are  specified,  then  the
              command modifies the given widget option(s) to have
              the given  value(s);   in  this  case  the  command
              returns  an  empty  string.  Option may have any of
              the values accepted by the dialog command.



EXAMPLE

               iwidgets::dialog .d -modality global
               .d buttonconfigure OK -command {puts OK; .d deactivate 1}
               .d buttonconfigure Apply -command {puts Apply}
               .d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}
               .d buttonconfigure Help -command {puts Help}

               listbox [.d childsite].lb -relief sunken
               pack [.d childsite].lb -expand yes -fill both

               } else {
                   puts "Exit via Cancel button"
               }



AUTHOR

       Mark L. Ulferts

       Bret A. Schuhmacher


KEYWORDS

       dialog, dialogshell, shell, widget









































Man(1) output converted with man2html