[incr Widgets] - selectiondialog manpage





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     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

       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   itemsLabel      itemsOn
       selectionCommand               selectionLabel  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

       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  selectiondialog command creates a selection box simi­
       lar 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  various operations on the widget.  It has the fol­
       lowing general form:

              pathName option ?arg arg ...?

       Option and the args determine the exact  behavior  of  the
       command.   The  following commands are possible for selec­
       tiondialog 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
       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  path­
              Name  (see  Tk_ConfigureInfo for information on the
              format of this list).  If option is specified  with
              no  value, then the command returns a list describ­
              ing the one named option (this list will be identi­
              cal  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  selection dialog.  See the "selectionbox" wid­
              get manual entry for details  on  the  selectionbox
              component item.



EXAMPLE

               iwidgets::selectiondialog .sd
               .sd activate



AUTHOR

       Mark L. Ulferts


KEYWORDS

       selectiondialog, selectionbox, dialog, dialogshell, shell,
       widget







Man(1) output converted with man2html