[incr Widgets] - dialog manpage
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.
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.
_________________________________________________________________
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 contain
ing 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
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
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 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 dialog command.
EXAMPLE
iwidgets::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
} else {
puts "Exit via Cancel button"
}
AUTHOR
Mark L. Ulferts
Bret A. Schuhmacher
KEYWORDS
dialog, dialogshell, shell, widget
Man(1) output converted with
man2html