NAME
promptdialog - Create and manipulate a prompt dialog wid
get
SYNOPSIS
promptdialog pathName ?options?
INHERITANCE
itk::Toplevel <- dialogshell <- dialog <- promptdialog
STANDARD OPTIONS
background borderWidth cursor exportSelection
foreground highlightColor highlightThicknessinsertBackground
insertBorderWidth insertOffTime insertOnTimeinsertWidth
relief selectBackground selectBorderWidthselectForeground
See the "options" manual entry for details on the standard
options.
ASSOCIATED OPTIONS
show
See the "entry" widget manual entry for details on the
above associated options.
invalid textBackground textFont validate
See the "entryfield" widget manual entry for details on
the above associated options.
labelFont labelPos labelText
See the "labeledwidget" widget manual entry for details on
the above associated options.
INHERITED OPTIONS
buttonBoxPadX buttonBoxPadY buttonBoxPos padX
padY separator thickness
See the "dialogshell" widget manual entry for details on
the above inherited options.
height master modality width
See the "shell" widget manual entry for details on the
above inherited options.
title
See the "Toplevel" widget manual entry for details on the
above inherited options.
DESCRIPTION
The promptdialog command creates a prompt dialog similar
to the OSF/Motif standard prompt dialog composite widget.
The promptdialog is derived from the dialog class and is
composed of a EntryField with commands to manipulate the
dialog buttons.
METHODS
The promptdialog command creates 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
command. The following commands are possible for prompt
dialog widgets:
ASSOCIATED METHODS
delete get icursor index
insert scan selection xview
See the "entry" widget manual entry for details on the
above associated methods.
clear
See the "entryfield" widget manual entry for details on
the above associated methods.
INHERITED METHODS
add buttonconfigure defaulthide
invoke show
See the "buttonbox" widget manual entry for details on the
above inherited methods.
childsite
See the "dialogshell" widget manual entry for details on
the above inherited methods.
activate center deactivate
See the "shell" widget manual entry for details on the
above inherited 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 promptdialog 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 promptdialog command.
COMPONENTS
Name: prompt
Class: Entryfield
The prompt component is the entry field for user
input in the prompt dialog. See the "entryfield"
widget manual entry for details on the prompt com
ponent item.
EXAMPLE
option add *textBackground white
promptdialog .pd -modality global -title Password -labeltext Password: -show *
.pd hide Apply
if {[.pd activate]} {
puts "Password entered: [.pd get]"
} else {
puts "Password prompt cancelled"
}
AUTHOR
Mark L. Ulferts
KEYWORDS
promptdialog, dialog, dialogshell, shell, widget
Man(1) output converted with
man2html