selectiondialog

selectiondialog(1)              [incr Widgets]              selectiondialog(1)



______________________________________________________________________________

NAME
       selectiondialog - Create and manipulate a selection dialog widget

SYNOPSIS
       selectiondialog pathName ?options?

INHERITANCE
       itk::Toplevel <- Shell <- Dialogshell <- Dialog <- Selectiondialog

STANDARD OPTIONS
       activeBackground               background      borderWidthcursor
       exportSelection foreground     highlightColor  highlightThickness
       insertBackground               insertBorderWidthinsertOffTimeinsertOnTime
       insertWidth     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 asso-
       ciated options.

       labelFont

       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.

       textBackground  textFont

       See the "scrolledlistbox" widget class manual entry for details on  the
       above   associated   options.   childsitepos    itemsCommand   itemsLa-
       bel      itemsOn  selectionCommand               selectionLabel  selec-
       tionOn

       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.

       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 inher-
       ited options.
______________________________________________________________________________


DESCRIPTION
       The  selectiondialog  command  creates  a  selection box similar to the
       OSF/Motif standard selection dialog composite widget.  The selectiondi-
       alog 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 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 selectiondialog 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  associ-
       ated methods.

INHERITED METHODS
       add             buttonconfigure                defaulthide
       invoke          show

       See the "buttonbox" widget manual entry for details on the above inher-
       ited 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 avail-
              able  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 selectiondialog command.


COMPONENTS
       Name:           selectionbox
       Class:          Selectionbox

              The  selectionbox  component is the selection box for the selec-
              tion dialog.  See the "selectionbox"  widget  manual  entry  for
              details on the selectionbox component item.


EXAMPLE
               selectiondialog .sd
               .sd activate


AUTHOR
       Mark L. Ulferts

KEYWORDS
       selectiondialog, selectionbox, dialog, dialogshell, shell, widget




Tk                                                          selectiondialog(1)