extfileselectionbox - Create and manipulate a file selection box widget
SYNOPSIS
extfileselectionbox pathName ?options?INHERITANCE
itk::Widget <- ExtfileselectionboxSTANDARD 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
popupCursor |
textBackground |
textFont |
See the "combobox" 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.
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 extfileselectionbox command creates an extended file selection box which is slightly different than the fileselectionbox 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 extfileselectionbox 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 extfileselectionbox 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 extfileselectionbox 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 extfileselectionbox command.
- pathName filter
- Update the current contents of the extended file selection box based on the current filter combobox value.
- pathName get
- Returns the current value of the selection combobox widget.
COMPONENTS
Name: dirs Class: Scrolledlistbox
Name: files Class: Scrolledlistbox
Name: filter Class: Combobox
Name: selection Class: Combobox
EXAMPLE
extfileselectionbox .fsb pack .fsb -padx 10 -pady 10 -fill both -expand yes
AUTHORS
Mark L. UlfertsAnthony Parent