# 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