[Contents] [Index] [Next] [Previous]

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:

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 FileSelectionBox must initiate a directory and file search when any of the following occurs:

Illustration

Related Information

For more information, see the reference page for FileSelectionDialog.