The Files window
Figure 2.7:
The Files window.
 |
- Window title:
- DsTool: File: (Action)
- Function:
- The File window is used to control the exchange of data between DsTool and
outside files.
- Description:
- The File window is opened by selecting any button which requires
interaction with outside files. Specifically, these buttons are the
Load and Save window buttons located in the C Code and Parser windows,
the File option from the Help menu button located in the Command window, the Load window
button in
the Load window, the Save window button in the Save window, the Go window button
in the Print window when the exclusive setting is ``File'', and the Go window
button in the Snapshot window. In each case, the Files
window provides the user with a convenient way to save or load a file.
- Panel items:
-
- Filter read-write text field:
Displays a string which is used to control the display of files in
the Files listbox. Only those files which match the string will be displayed.
The string should use the usual UNIX wildcards: asterisk, question mark, etc.
If the field is blank, no files will be
displayed. If the field contains only an asterisk, then all of the files
in the specified directory will be displayed.
Pressing Return or pressing the Filter command button will apply the filter
to the Files listbox. The default value for this text field depends upon which
button caused the creation of the Files window.
- Directory listbox:
Allows the user to choose a directory from which to select a file.
The listbox contains the current directory, the parent directory, and
a list of the subdirectories of the current
directory. Double
clicking on a directory name in the listbox changes the current directory to the
selected one.
The entries in the Files listbox change accordingly.
- Files listbox:
Allows the user to choose a file in the given directory.
The listbox contains a list of the files contained in the current
directory which match the filter string. Double clicking on a file
causes it to be selected for the action of the window. If the action
is saving to a file, DsTool will ask for confirmation before overwriting the file.
If the action is loading a file, DsTool will load the file.
- Directory read-write text field:
Displays the current working directory. Pressing Return while the cursor is in
this field updates the Directory and Files listboxes. The
default value of this text field depends upon which button caused the
creation of the Files window.
- Filename read-write text field:
Displays the current filename, which will be used for the
specified action if the OK button is pressed. The default
value of this field depends upon which button caused the creation of
the Files window.
- OK command button:
Causes the specified action (save or load) to be performed,
using the current filename and directory. If the action is ``Save''
and the file doesn't exist, DsTool will create and write to the file.
If the file does exist, DsTool will ask for confirmation before overwriting the file.
If the action is ``Load'' and the file doesn't exist, an error message will
be printed. If the file does exist, DsTool will load the file.
- Filter command button:
Causes the specified filter to be applied to the files which
appear in the Files listbox.
- Dismiss command button:
Closes the Files window.
Adrian Bunk
2001-08-22