# 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