# iwidgets2.2.0 User Commands - fileselectiondialog

##

## NAME

         fileselectiondialog - Create and manipulate a file selection
         dialog widget

## SYNOPSIS

         fileselectiondialog pathName ?options?

## INHERITANCE

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

## STANDARD OPTIONS

         activeBackground               background      borderWidthcursor
         foreground      highlightColor highlightThicknessinsertBackground
         insertBorderWidth              insertOffTime   insertOnTimeinsertWidth
         relief          repeatDelay    repeatInterval  selectBackground
         selectBorderWidth              selectForeground

         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
         dirsFraction    dirsLabelPos   dirsOn          filesLabel
         filesLabelOn    fileSearchCommand              filesLabelPosfilesOn
         fileType        filterLabel    filterLabelPos  filterOn
         invalid         mask           noMatchString   selectionCommand
         selectionLabel  selectionLabelPos              selectionOnstyle
         vertMargin

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

         labelFont       labelMargin

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

         horizMargin     hscrollMode    sbWidth         scrollMargin
         textBackground  textFont       vScrollMode

         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.

## INHERITED OPTIONS

         buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
         padY            separator      thickness

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

         master          modality       title

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

## WIDGET-SPECIFIC OPTIONS

         Name:           height
         Class:          Height
         Command-Line Switch:           -height

              Specifies the height of the file selection dialog.  The
              value  may  be specified in any of the forms acceptable
              to Tk_GetPixels.  The default is 435 pixels.

         Name:           width
         Class:          Width
         Command-Line Switch:           -width

              Specifies the width of the file selection dialog.   The
              value  may  be specified in any of the forms acceptable
              to Tk_GetPixels.  The default is 450 pixels.

##

## 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 following gen-
         eral form:

              pathName option ?arg arg ...?

         Option and the args determine the exact behavior of the com-
         mand.   The  following  commands are possible for fileselec-
         tiondialog 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

         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 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  pathName
              (see  Tk_ConfigureInfo 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  correspond-
              ing  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  component
              item.

## EXAMPLE

               option add *textBackground white

               fileselectiondialog .fsd
               .fsd activate

## AUTHOR

         Mark L. Ulferts

## KEYWORDS

         fileselectiondialog, fileselectionbox, dialog,  dialogshell,
         shell, widget