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