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