|
ActiveTcl User Guide |
 |
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
padY
|
buttonBoxPadY
separator
|
buttonBoxPos
thickness
|
padX
|
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.
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 containing 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 command. The following commands are possible for dialog
widgets:
INHERITED METHODS
add
index
|
buttonconfigure
insert
|
default
invoke
|
hide
show
|
See the "buttonbox" manual entry
for details on the above inherited methods.
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 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
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"
}
AUTHORS
Mark L. Ulferts
Bret A. Schuhmacher
KEYWORDS
dialog, dialogshell, shell, widget
|
