FileSelectionBox

Description

A FileSelectionBox is a special-purpose composite component for file selection. It can be used to traverse through directories, view the files and subdirectories in them, and then select files. The FileSelectionBox must be composed of at least the following components:

• A Text component for displaying and editing a directory mask used to select the files to be displayed. The directory mask must be a string specifying the base directory to be examined and a search pattern.
• A List component for displaying filenames. The file list should display all files and subdirectories in the base directory that match the search pattern. The List must use either the single or browse selection model.
• A List component for displaying subdirectories. The directory list should display the subdirectories of the base directory, as well as the base directory itself and its parent directory. The List must use either the single or browse selection model.
• A Text component for displaying and editing a filename.
• A group of PushButtons, labeled OK, Filter, Cancel, and Help. If the FileSelectionBox is used to perform a specific action to the selected files, OK can be replaced by a label describing the action to be done.
• Additional elements can be added by an application.

The user must be able to select a new directory to examine by scrolling through the list of directories and selecting the desired directory or by editing the directory mask. Selecting a new directory from the directory list must not change the search pattern. A user must be able to select a new search pattern by editing the directory mask.

The List navigation actions , , , and must be available from the Text components for moving the cursored element within each List and thus changing the contents of the Text. The List navigation actions and should also be available from the Text components for moving the cursored element within each List. The contents of the directory Text must correspond to the contents of the directory List, and the contents of the filename Text must correspond to the contents of the filename List.

The user must be able to select a file by scrolling through the list of filenames and selecting the desired file or by entering the filename directly into the Text component. Selecting a file from the list causes that filename to appear in the file selection Text component.

The user can select a new file as many times as desired. The application must not be notified until one of the following events occurs:

• The user activates the OK PushButton.
• The user presses [Enter] or while the filename Text component has the keyboard focus.
• The user presses [Enter] or while the location cursor is on an item in the file List.
• The user double-clicks BSelect on an item in the file List.

The FileSelectionBox must initiate a directory and file search when any of the following occurs:

• The FileSelectionBox is initialized.
• The user activates the Filter PushButton.
• The user double-clicks or presses [Enter] or on an item in the directory List.
• The user presses [Enter] or while the directory mask Text edit area has the keyboard focus.

Illustration

Related Information

For more information, see the reference page for FileSelectionDialog.