iwidgets2.2.0 User Commands - selectiondialog
NAME
selectiondialog - Create and manipulate a selection dialog
widget
SYNOPSIS
selectiondialog pathName ?options?
INHERITANCE
itk::Toplevel <- Shell <- Dialogshell <- Dialog <- Selec-
tiondialog
STANDARD OPTIONS
activeBackground background borderWidthcursor
exportSelection foreground highlightColor highlightThickness
insertBackground insertBorderWidthinsertOffTimeinsertOnTime
insertWidth relief repeatDelay repeatInterval
selectBackground selectBorderWidthselectForeground
See the "options" manual entry for details on the standard
options.
ASSOCIATED OPTIONS
textBackground textFont
See the "entryfield" widget manual entry for details on the
above associated options.
labelFont labelMargin
See the "labeledwidget" widget manual entry for details on
the above associated options.
activeRelief elementBorderWidth jumptroughColor
See the "scrollbar" widget class manual entry for details on
the above associated options.
hscrollMode items sbWidth scrollMargin
textBackground textFont vscrollMode
See the "scrolledlistbox" widget class manual entry for
details on the above associated options.
childsitepos itemsCommand itemsLabel itemsLabelPos
itemsOn margin selectionCommandselectionLabel
selectionLabelPos selectionOn
See the "selectionbox" 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.
master modality title
See the "shell" widget manual entry for details on the
above inherited options.
WIDGET-SPECIFIC OPTIONS
Name: height
Class: Height
Command-Line Switch: -height
Specifies the height of the selection dialog. The
value may be specified in any of the forms acceptable
to Tk_GetPixels. The default is 350 pixels.
Name: width
Class: Width
Command-Line Switch: -width
Specifies the width of the selection dialog. The value
may be specified in any of the forms acceptable to
Tk_GetPixels. The default is 300 pixels.
DESCRIPTION
The selectiondialog command creates a selection box similar
to the OSF/Motif standard selection dialog composite widget.
The selectiondialog is derived from the Dialog class and is
composed of a selectionbox with commands to manipulate the
dialog buttons.
METHODS
The selectiondialog command creates a new Tcl command whose
name is pathName. This command may be used to invoke vari-
ous operations on the widget. It has the following general
form:
pathName option ?arg arg ...?
Option and the args determine the exact behavior of the com-
mand. The following commands are possible for selectiondia-
log widgets:
ASSOCIATED METHODS
childsite clear get insert
selectitem
See the "selectionbox" widget manual entry for details on
the above associated methods.
curselection delete index nearest
scan selection size
See the "listbox" 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.
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 selectiondialog 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 correspond-
ing 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 selectiondialog command.
COMPONENTS
Name: sb
Class: Selectionbox
The sb component is the selection box for the selection
dialog.
See the "selectionbox" widget manual entry for details
on the sb component item.
EXAMPLE
option add *textBackground GhostWhite
selectiondialog .sd
.sd activate
AUTHOR
Mark L. Ulferts
KEYWORDS
selectiondialog, selectionbox, dialog, dialogshell, shell,
widget