iwidgets2.2.0 User Commands - dialog






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.

     master          modality       title

     See the "shell" manual entry for details on the above inher-
     ited 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 containing
     box.



METHODS

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

          pathName option ?arg arg ...?

     Option and the args determine the exact behavior of the com-
     mand.   The following commands are possible for dialog widg-
     ets:


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 inher-
     ited 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  pathName
          (see  Tk_ConfigureInfo for information on the format of
          this list).  If option is specified with no value, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  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

           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

           if {[.d activate]} {
               puts "Exit via OK button"
           } else {
               puts "Exit via Cancel button"
           }



AUTHOR

     Mark L. Ulferts

     Bret A. Schuhmacher


KEYWORDS

     dialog, dialogshell, shell, widget