| FSL Programmer's Manual - FSLFileEntry(3Tkl)
| 
|
NAME
FSLFileEntry - A tix mega-widget generating a file entry box and browser.
SYNOPSIS
FSLFileEntry pathName ?options?
WIDGET-SPECIFIC OPTIONS
Command-Line Name: -command
Database Name: command
Database Class: Command
Specifies the command that is run when a selection is made from the dialog box. Note that the command string specified will be appended with the file/directory selected.
Command-Line Name: -dirasfile
Database Name: dirasfile
Database Class: Dirasfile
This option displays directories that contain the specified file as a selectable file.
Command-Line Name: -directory
Database Name: directory
Database Class: Directory
Specifies the starting directory for the file select dialog box. Note that after creation the dialog box directory can be changed only by
[$pathname subwidget fsbox] subwidget fsbox config -directory $dirname
Command-Line Name: -filterhist
Database Name: filterhist
Database Class: Filterhist
Specifies the global variable in which the filter history should be stored. This enables multiple FSLFileEntry widgets to essentially share the same history.
Command-Line Name: -label
Database Name: label
Database Class: Label
Specifies the text to be used as a label for the FileEntry box.
Command-Line Name: -labelwidth
Database Name: labelwidth
Database Class: Labelwidth
Specifies the width of the label.
Command-Line Name: -pattern
Database Name: pattern
Database Class: Pattern
Specifies the matching pattern of the file names that should be listed in the Files listbox. For example "*.txt" matches all the filenames that end with ".txt". If this option is set to the empty string, the default pattern "*" will be used.
Command-Line Name: -showdotfiles
Database Name: showdotfiles
Database Class: Showdotfiles
A boolean value indicating whether files with "." as their first character should be shown. The default is set to false.
Command-Line Name: -title
Database Name: title
Database Class: Title
Specifies the title to be used on the file select dialog box.
Command-Line Name: -variable
Database Name: variable
Database Class: Variable
Specifies the global variable in which the value of the FileEntry should be stored. The value of the FileEntry will be automatically updated when this variable is changed.
Command-Line Name: -width
Database Name: width
Database Class: Width
Specifies the width of the entry box.
DESCRIPTION
The FSLFileEntry widget creates a file entry box, together with a browse button for file selection. This has some of the functionality of tixFileEntry, but not all. It's main feature is its use of the FSLFileDirDlg and FSLFileDirBox widgets which enable better control of the filters and the history.
Stuart Clare
FMRIB Centre
Copyright © 2000, University of Oxford