NAME

       dialogshell - Create and manipulate a dialog shell widget


SYNOPSIS

       dialogshell pathName ?options?


INHERITANCE

       itk::Toplevel <- Shell <- Dialogshell


STANDARD OPTIONS

       background      cursor         foreground

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


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.


WIDGET-SPECIFIC OPTIONS

       Name:           buttonBoxPadX
       Class:          Pad
       Command-Line Switch:           -buttonboxpadx

              Specifies a non-negative padding distance to  leave
              between  the button group and the outer edge of the
              button box in the x direction.  The  value  may  be
              given  in any of the forms accpetable to Tk_GetPix­
              els.  The default is 5 pixels.

       Name:           buttonBoxPadY
       Class:          Pad
       Command-Line Switch:           -buttonboxpady

              Specifies a non-negative padding distance to  leave
              between  the button group and the outer edge of the
              button box in the y direction.  The  value  may  be
              given  in any of the forms accpetable to Tk_GetPix­
              els.  The default is 5 pixels.

       Name:           buttonBoxPos
       Class:          Position
       Command-Line Switch:           -buttonboxpos

              n, s, e or w.  The default is s.

       Name:           padX
       Class:          Pad
       Command-Line Switch:           -padx

              Specifies  a  padding distance for the childsite in
              the X-direction in any of the forms  acceptable  to
              Tk_GetPixels.  The default is 10.

       Name:           padY
       Class:          Pad
       Command-Line Switch:           -pady

              Specifies  a  padding distance for the childsite in
              the Y-direction in any of the forms  acceptable  to
              Tk_GetPixels.  The default is 10.

       Name:           separator
       Class:          Separator
       Command-Line Switch:           -separator

              Specifies  whether  a line is drawn to separate the
              buttons from the dialog box contents in any of  the
              forms acceptable to Tcl_GetBoolean.  The default is
              true.

       Name:           thickness
       Class:          Thickness
       Command-Line Switch:           -thickness

              Specifies the thickness of the separator in any  of
              the  forms acceptable to Tk_GetPixels.  The default
              is 3 pixels.
_________________________________________________________________


DESCRIPTION

       The dialogshell command creates a dialog shell which is  a
       top  level widget composed of a button box, separator, and
       child site area.  The class also has  methods  to  control
       button construction.


METHODS

       The  dialogshell  command  create  a new Tcl command whose
       name is pathName.  This command may be used to invoke var­
       ious  operations on the widget.  It has the following gen­
       eral form:

              pathName option ?arg arg ...?

       Option and the args determine the exact  behavior  of  the

       dialogshell widgets:


INHERITED METHODS

       activate        center         deactivate

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


ASSOCIATED METHODS

       add             buttonconfigure                defaultdelete
       hide            index          insert          invoke
       show

       See  the "buttonbox" manual entry for details on the asso­
       ciated 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 dialogshell command.

       pathName childsite
              Returns the pathname of the child site widget.

       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 dialogshell command.


COMPONENTS

       Name:           dschildsite
       Class:          frame

              The  dschildsite  component  is the user child site
              for the dialog shell.  See the "frame" widget  man­
              ual  entry for details on the dschildsite component
              item.

       Name:           separator
       Class:          frame

              the  user  child  site and the button box.  See the
              "frame" widget manual entry for details on the sep­
              arator component item.

       Name:           bbox
       Class:          ButtonBox

              The bbox component is the button box containing the
              buttons for the dialog shell.  See the  "ButtonBox"
              widget  manual entry for details on the bbox compo­
              nent item.


EXAMPLE

               dialogshell .ds -modality none

               .ds add OK -text "OK"
               .ds add Cancel -text "Cancel"
               .ds default OK

               .ds activate


AUTHOR

       Mark L. Ulferts


KEYWORDS

       dialogshell, dialog, shell, widget


Man(1) output converted with man2html