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

NAME
       iwidgets::selectiondialog  -  Create  and manipulate a selection dialog
       widget

SYNOPSIS
       iiwwiiddggeettss::::sseelleeccttiioonnddiiaalloogg pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Toplevel <-  iwidgets::Shell  <-  iwidgets::Dialogshell  <-  iwid-
       gets::Dialog <- iwidgets::Selectiondialog

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       aaccttiivveeBBaacckkggrroouunndd  bbaacckkggrroouunndd         bboorrddeerrWWiiddtthh        ccuurrssoorr
       eexxppoorrttSSeelleeccttiioonn   ffoorreeggrroouunndd         hhiigghhlliigghhttCCoolloorr     hhiigghhlliigghhttTThhiicckknneessss
       iinnsseerrttBBaacckkggrroouunndd  iinnsseerrttBBoorrddeerrWWiiddtthh  iinnsseerrttOOffffTTiimmee      iinnsseerrttOOnnTTiimmee
       iinnsseerrttWWiiddtthh       sseelleeccttBBaacckkggrroouunndd   sseelleeccttBBoorrddeerrWWiiddtthh  sseelleeccttFFoorreeggrroouunndd

       See the "options" manual entry for details on the standard options.

AASSSSOOCCIIAATTEEDD OOPPTTIIOONNSS
       tteexxttBBaacckkggrroouunndd  tteexxttFFoonntt

       See the "entryfield" widget manual entry for details on the above asso-
       ciated options.

       llaabbeellFFoonntt

       See the "labeledwidget" widget manual entry for details  on  the  above
       associated options.

       aaccttiivveeRReelliieeff    eelleemmeennttBBoorrddeerrWWiiddtthh             jjuummppttrroouugghhCCoolloorr

       See  the "scrollbar" widget class manual entry for details on the above
       associated options.

       tteexxttBBaacckkggrroouunndd  tteexxttFFoonntt

       See the "scrolledlistbox" widget class manual entry for details on  the
       above   associated   options.   cchhiillddssiitteeppooss    iitteemmssCCoommmmaanndd   iitteemmssLLaa-
       bbeell      iitteemmssOOnn  sseelleeccttiioonnCCoommmmaanndd               sseelleeccttiioonnLLaabbeell  sseelleecc-
       ttiioonnOOnn

       See  the  "selectionbox"  widget  manual entry for details on the above
       associated options.

IINNHHEERRIITTEEDD OOPPTTIIOONNSS
       bbuuttttoonnBBooxxPPaaddXX   bbuuttttoonnBBooxxPPaaddYY  bbuuttttoonnBBooxxPPooss    ppaaddXX
       ppaaddYY            sseeppaarraattoorr      tthhiicckknneessss

       See the "dialogshell" widget  manual entry for  details  on  the  above
       inherited options.

       hheeiigghhtt          mmaasstteerr         mmooddaalliittyy        wwiiddtthh

       See the "shell" widget  manual entry for details on the above inherited
       options.

       ttiittllee

       See the "Toplevel" widget  manual entry for details on the above inher-
       ited options.



DESCRIPTION
       The  iiwwiiddggeettss::::sseelleeccttiioonnddiiaalloogg  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.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::sseelleeccttiioonnddiiaalloogg command creates a new Tcl  command  whose
       name  is  pathName.   This command may be used to invoke various opera-
       tions 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:

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       cchhiillddssiittee       cclleeaarr          ggeett             iinnsseerrtt
       sseelleeccttiitteemm

       See  the  "selectionbox"  widget  manual entry for details on the above
       associated methods.

       ccuurrsseelleeccttiioonn    ddeelleettee         iinnddeexx           nneeaarreesstt
       ssccaann            sseelleeccttiioonn      ssiizzee

       See the "listbox" widget manual entry for details on the above  associ-
       ated methods.

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauulltthhiiddee
       iinnvvookkee          sshhooww

       See the "buttonbox" widget manual entry for details on the above inher-
       ited methods.

       aaccttiivvaattee        cceenntteerr         ddeeaaccttiivvaattee

       See the "shell" widget manual entry for details on the above  inherited
       methods.

WWIIDDGGEETT-SSPPEECCIIFFIICC MMEETTHHOODDSS
       pathName ccggeett option
              Returns  the  current value of the configuration option given by
              option.  Option may have any of the values accepted by the iiwwiidd-
              ggeettss::::sseelleeccttiioonnddiiaalloogg command.

       pathName ccoonnffiigguurree ?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 TTkkCCoonnffiigguurreeIInnffoo 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 iiwwiiddggeettss::::sseelleeccttiioonnddiiaalloogg command.


CCOOMMPPOONNEENNTTSS
       Name:           sseelleeccttiioonnbbooxx
       Class:          SSeelleeccttiioonnbbooxx

              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.


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               iwidgets::selectiondialog .sd
               .sd activate


AUTHOR       Mark L. Ulferts

KKEEYYWWOORRDDSS
       selectiondialog, selectionbox, dialog, dialogshell, shell, widget




Tk                                                iwidgets::selectiondialog(1)