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