iwidgets::extfileselectiondialog([1i)ncr Widgetisw]idgets::extfileselectiondialog(1)

NAME
       iwidgets::extfileselectiondialog  - Create and manipulate a file selec-
       tion dialog widget

SYNOPSIS
       iiwwiiddggeettss::::eexxttffiilleesseelleeccttiioonnddiiaalloogg pathName ?options?

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

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
       ppooppuuppCCuurrssoorr     tteexxttBBaacckkggrroouunndd tteexxttFFoonntt

       See the "combobox" widget manual entry for details on the above associ-
       ated options.

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

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

       llaabbeellFFoonntt

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

       ssaasshhCCuurrssoorr

       See the "panedwindow" widget manual entry  for  details  on  the  above
       associated 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 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::::eexxttffiilleesseelleeccttiioonnddiiaalloogg  command creates an extended file
       selection dialog which is slightly different than the fileselectiondia-
       log  widget.  The differences are mostly cosmetic in that the listboxes
       are within a panedwindow and the entryfields for the filter and  selec-
       tion  have  been replaced by comboboxes.  Other than that the interface
       is practically the same.


MMEETTHHOODDSS
       The iiwwiiddggeettss::::eexxttffiilleesseelleeccttiioonnddiiaalloogg 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 extfileselectiondialog 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::::eexxttffiilleesseelleeccttiioonnddiiaalloogg 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::::eexxttffiilleesseelleeccttiioonnddiiaalloogg
              command.


CCOOMMPPOONNEENNTTSS
       Name:           ffssbb
       Class:          FFiilleesseelleeccttiioonnbbooxx

              The  fsb component is the extfileselectionbox for the extfilese-
              lectiondialog.   See  the  "extfileselectionbox"  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::extfileselectiondialog .nmfsd -title Non-Modal
               .nmfsd buttonconfigure OK -command okCallback

               .nmfsd activate

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

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


AUTHOR       Mark L. Ulferts

       Anthony L. Parent

KKEEYYWWOORRDDSS
       extfileselectiondialog,   extfileselectionbox,   dialog,   dialogshell,
       shell, widget



Tk                                         iwidgets::extfileselectiondialog(1)