promptdialog - Create and manipulate a prompt dialog widget
SYNOPSIS
promptdialog pathName ?options?INHERITANCE
itk::Toplevel <- dialogshell <- dialog <- promptdialogSTANDARD OPTIONS
background foreground insertBorderWidth relief |
borderWidth highlightColor insertOffTime selectBackground |
cursor highlightThickness insertOnTime selectBorderWidth |
exportSelection insertBackground insertWidth selectForeground |
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 padY |
buttonBoxPadY separator |
buttonBoxPos thickness |
padX |
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 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 promptdialog widgets:
ASSOCIATED METHODS
delete insert |
get scan |
icursor selection |
index 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 invoke |
buttonconfigure show |
default |
hide |
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.
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 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 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 promptdialog command.
COMPONENTS
Name: prompt Class: Entryfield
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" }