1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
\section{The Files window}\index{Files window}\index{window, Files}\label{window, files}
%
%
%
\begin{figure}[H]
%\vspace{1.0in}
\centerline{\psfig{figure=ps/filesl.ps,height=191pt}}
\caption{\label{fileswin}
The Files window.
}
\end{figure}
%
%
%
\begin{description}
\item[Window title:] DsTool: File: (Action)
\item[Function:] The File window is used to control the exchange of data between DsTool and
outside files.
\item[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.
\item[Panel items:]\mbox{}
\begin{itemize}
\item 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 \unix{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.
\item 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
% directory, as well as the ``.'' and ``..'' directories which correspond to
% the current directory and the parent directory, respectively. 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.
\item 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.
% try to overwrite the given file, causing a notifier\index{notifier} to pop up.
If the action is loading a file, DsTool will load the file.
\item Directory read-write text field:
Displays the current working directory. Pressing \unix{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.
\item 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.
\item 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.
\item Filter command button:
Causes the specified filter to be applied to the files which
appear in the Files listbox.
% causing only those files which match the filter to be displayed.
\item Dismiss command button:
Closes the Files window.
%The current options revert to their defaults.
\end{itemize}
\end{description}
|
