[incr Widgets] - extfileselectiondialog manpage





NAME

       extfileselectiondialog  -  Create  and  manipulate  a file
       selection dialog widget


SYNOPSIS

       extfileselectiondialog pathName ?options?


INHERITANCE

       itk::Toplevel  <-  Shell  <-  Dialogshell  <-  Dialog   <-
       Extfileselectiondialog


STANDARD OPTIONS

       activeBackground               background      borderWidthcursor
       foreground      highlightColor highlightThicknessinsertBackground
       insertBorderWidth              insertOffTime   insertOnTimeinsertWidth
       selectBackground               selectBorderWidthselectForeground

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


ASSOCIATED OPTIONS

       popupCursor     textBackground textFont

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

       childSitePos    directory      dirsLabel       dirSearchCommand
       dirsOn          filesLabel     filesLabelOn    fileSearchCommand
       filesOn         fileType       filterLabel     filterOn
       invalid         mask           noMatchString   selectionLabel
       selectionOn

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

       labelFont

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

       sashCursor

       See  the  "panedwindow" 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
       on the above associated options.

       textBackground  textFont

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

       height          master         modality        width

       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 extfileselectiondialog  command  creates  an  extended
       file selection dialog which is slightly different than the
       fileselectiondialog widget.  The  differences  are  mostly
       cosmetic  in  that  the listboxes are within a panedwindow
       and the entryfields for the filter and selection have been
       replaced  by comboboxes.  Other than that the interface is
       practically the same.



METHODS

       The extfileselectiondialog command creates a new Tcl  com­
       mand  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 extfile­
       selectiondialog widgets:


ASSOCIATED METHODS

       get             childsite      filter



INHERITED METHODS

       add             buttonconfigure                defaulthide
       insert          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 extfileselectiondialog  com­
              mand.

       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  extfileselectiondialog
              command.



COMPONENTS

       Name:           fsb
       Class:          Fileselectionbox

              The  fsb  component  is the extfileselectionbox for
              the extfileselectiondialog.  See the "extfileselec­
              tionbox" widget manual entry for details on the fsb
              component item.



EXAMPLE

               #
               # Non-modal example
                   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


KEYWORDS

       extfileselectiondialog,    extfileselectionbox,    dialog,
       dialogshell, shell, widget























Man(1) output converted with man2html