fileselectionbox - Create and manipulate a file selection box widget
SYNOPSIS
fileselectionbox pathName ?options?INHERITANCE
itk::Widget <- FileselectionboxSTANDARD OPTIONS
activeBackground foreground insertBorderWidth selectBackground |
background highlightColor insertOffTime selectBorderWidth |
borderWidth highlightThickness insertOnTime selectForeground |
cursor insertBackground insertWidth |
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.
labelFont |
See the "labeledwidget" widget manual entry for details on the above associated options.
activeRelief |
elementBorderWidth |
jump |
troughColor |
See the "scrollbar" widget class manual entry for details on the above associated options.
textBackground |
textFont |
See the "scrolledlistbox" widget manual entry for details on the above associated options.
WIDGET-SPECIFIC OPTIONS
Name: childSitePos Class: Position Command-Line Switch: -childsitepos
Name: directory Class: Directory Command-Line Switch: -directory
Name: dirSearchCommand Class: Command Command-Line Switch: -dirsearchcommand
Name: dirsLabel Class: Text Command-Line Switch: -dirslabel
Name: dirsOn Class: DirsOn Command-Line Switch: -dirson
Name: fileSearchCommand Class: Command Command-Line Switch: -filesearchcommand
Name: filesLabel Class: Text Command-Line Switch: -fileslabel
Name: filesOn Class: FilesOn Command-Line Switch: -fileson
Name: fileType Class: FileType Command-Line Switch: -filetype
Name: filterCommand Class: Command Command-Line Switch: -filtercommand
Name: filterLabel Class: Text Command-Line Switch: -filterlabel
Name: filterOn Class: FilterOn Command-Line Switch: -filteron
Name: height Class: Height Command-Line Switch: -height
Name: invalid Class: Command Command-Line Switch: -invalid
Name: mask Class: Mask Command-Line Switch: -mask
Name: noMatchString Class: NoMatchString Command-Line Switch: -nomatchstring
Name: selectDirCommand Class: Command Command-Line Switch: -selectdirommand
Name: selectFileCommand Class: Command Command-Line Switch: -selectfileommand
Name: selectionCommand Class: Command Command-Line Switch: -selectioncommand
Name: selectionLabel Class: Text Command-Line Switch: -selectionlabel
Name: selectionOn Class: SelectionOn Command-Line Switch: -selectionon
Name: width Class: Width Command-Line Switch: -width
DESCRIPTION
The fileselectionbox command creates a file selection box similar to the OSF/Motif standard Xmfileselectionbox composite widget. The fileselectionbox is composed of directory and file scrolled lists as well as filter and selection entry fields. Bindings are in place such that selection of a directory list item loads the filter entry field and selection of a file list item loads the selection entry field. Options exist to control the appearance and actions of the widget.
METHODS
The fileselectionbox 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 fileselectionbox widgets:
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 fileselectionbox command.
- pathName childsite
- Returns the child site widget path name.
- 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 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 fileselectionbox command.
- pathName filter
- Update the current contents of the file selection box based on the current filter entry field value.
- pathName get
- Returns the current value of the selection entry widget.
COMPONENTS
Name: dirs Class: Scrolledlistbox
Name: files Class: Scrolledlistbox
Name: filter Class: Entryfield
Name: selection Class: Entryfield
EXAMPLE
fileselectionbox .fsb pack .fsb -padx 10 -pady 10 -fill both -expand yes