dialogshell(1)							  [incr Widgets]						    dialogshell(1)

__________________________________________________________________________________________________________________________________________________

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_GetPixels.  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_GetPixels.  The default is 5 pixels.

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

	      Attaches buttons to the given side of the dialog: 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_Get-
	      Boolean.	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 various operations on the wid-
       get.  It has the following general form: pathName option ?arg arg ...?  Option and the args determine the exact behavior  of  the  command.
       The following commands are possible for 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 associated 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 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 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 manual entry for details on the
	      dschildsite component item.

       Name:	       separator
       Class:	       frame

	      The separator component devides the area between the user child site and the button box.	See the "frame" widget	manual	entry  for
	      details on the separator 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 component 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

Tk																    dialogshell(1)