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

NAME
       iwidgets::fileselectiondialog  - Create and manipulate a file selection
       dialog widget

SYNOPSIS
       iiwwiiddggeettss::::ffiilleesseelleeccttiioonnddiiaalloogg pathName ?options?

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

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       aaccttiivveeBBaacckkggrroouunndd   bbaacckkggrroouunndd         bboorrddeerrWWiiddtthh         ccuurrssoorr
       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.

       cchhiillddSSiitteePPooss    ddiirreeccttoorryy      ddiirrssLLaabbeell       ddiirrSSeeaarrcchhCCoommmmaanndd
       ddiirrssOOnn          ffiilleessLLaabbeell     ffiilleessLLaabbeellOOnn    ffiilleeSSeeaarrcchhCCoommmmaanndd
       ffiilleessOOnn         ffiilleeTTyyppee       ffiilltteerrLLaabbeell     ffiilltteerrOOnn
       iinnvvaalliidd         mmaasskk           nnooMMaattcchhSSttrriinngg   sseelleeccttiioonnLLaabbeell
       sseelleeccttiioonnOOnn

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

       llaabbeellFFoonntt

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

       tteexxttBBaacckkggrroouunndd  tteexxttFFoonntt

       See the "scrolledlistbox" 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.


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::::ffiilleesseelleeccttiioonnddiiaalloogg command creates a file selection dia-
       log similar to the OSF/Motif standard composite widget.  The fileselec-
       tiondialog is derived from the Dialog class and is composed of a FileS-
       electionBox with attributes set to manipulate the dialog buttons.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::ffiilleesseelleeccttiioonnddiiaalloogg 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 fileselectiondialog widgets:

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       ggeett             cchhiillddssiittee      ffiilltteerr

       See  the "fileselectionbox" class manual entry for details on the asso-
       ciated methods.

IINNHHEERRIITTEEDD MMEETTHHOODDSS
       aadddd             bbuuttttoonnccoonnffiigguurree                ddeeffaauulltthhiiddee
       iinnsseerrtt          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::::ffiilleesseelleeccttiioonnddiiaalloogg 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::::ffiilleesseelleeccttiioonnddiiaalloogg com-
              mand.


CCOOMMPPOONNEENNTTSS
       Name:           ffssbb
       Class:          FFiilleesseelleeccttiioonnbbooxx

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


EEXXAAMMPPLLEE
               package require Iwidgets 4.0
               #
               # Non-modal example
               #
               proc okCallback {} {
                   puts "You selected [.nmfsd get]"
                   .nmfsd deactivate
               }

               iwidgets::fileselectiondialog .nmfsd -title Non-Modal
               .nmfsd buttonconfigure OK -command okCallback

               .nmfsd activate

               #
               # Modal example
               #
               iwidgets::fileselectiondialog .mfsd -modality application
               .mfsd center

               if {[.mfsd activate]} {
                   puts "You selected [.mfsd get]"
               } else {
                   puts "You cancelled the dialog"
               }


AUTHOR       Mark L. Ulferts

KKEEYYWWOORRDDSS
       fileselectiondialog, fileselectionbox, dialog, dialogshell, shell, wid-
       get



Tk                                            iwidgets::fileselectiondialog(1)