NAME

       fileselectiondialog  - Create and manipulate a file selec­
       tion dialog widget


SYNOPSIS

       fileselectiondialog pathName ?options?


INHERITANCE

       itk::Toplevel <- Shell <- Dialogshell <- Dialog <- Filese­
       lectiondialog


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

       textBackground  textFont

       See the "entryfield" 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 "fileselectionbox" widget manual entry for details
       on the above associated options.

       labelFont

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

       textBackground  textFont

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

       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 fileselectiondialog command creates a  file  selection
       dialog similar to the OSF/Motif standard composite widget.
       The fileselectiondialog is derived from the  Dialog  class
       and  is composed of a FileSelectionBox with attributes set
       to manipulate the dialog buttons.


METHODS

       The fileselectiondialog 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  filese­
       lectiondialog widgets:


ASSOCIATED METHODS

       get             childsite      filter

       See  the "fileselectionbox" class manual entry for details
       on the associated methods.


INHERITED METHODS

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


COMPONENTS

       Name:           fsb
       Class:          Fileselectionbox

              The fsb component is the file selection box for the
              file selection dialog.  See the  "fileselectionbox"
              widget  manual  entry for details on the fsb compo­
              nent item.


EXAMPLE

               #
               # Non-modal example
               #
               proc okCallback {} {
                   puts "You selected [.nmfsd get]"
                   .nmfsd deactivate
               }

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

               .nmfsd activate

               #
               # Modal example

               fileselectiondialog .mfsd -modality application
               .mfsd center

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


AUTHOR

       Mark L. Ulferts


KEYWORDS

       fileselectiondialog,       fileselectionbox,       dialog,
       dialogshell, shell, widget


Man(1) output converted with man2html