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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998)
originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Conventions</TITLE>
<META NAME="description" CONTENT="Conventions">
<META NAME="keywords" CONTENT="userman">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="userman.css">
<LINK REL="next" HREF="node7.html">
<LINK REL="previous" HREF="node5.html">
<LINK REL="up" HREF="node5.html">
<LINK REL="next" HREF="node7.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html640"
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html637"
HREF="node5.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html631"
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html639"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html641"
HREF="node7.html">The Command Window</A>
<B> Up:</B> <A NAME="tex2html638"
HREF="node5.html">Attributes of Interface Windows</A>
<B> Previous:</B> <A NAME="tex2html632"
HREF="node5.html">Attributes of Interface Windows</A>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION00410000000000000000">
Conventions</A>
</H1>
The original version of the DsTool toolkit was written to conform to the
SUN <EM>Open Look</EM>
<!-- MATH: $^{\mbox{\tiny\copyright}}$ -->
2#2
conventions.
This version was written using the Tcl/Tk toolkit, but adheres to the
Open Look conventions whenever possible. For example,
a menu entry with trailing ellipses implies
the entry will generate a pop-up window if selected.
We will also use the Open Look nomenclature SELECT<A NAME="71"> </A>,
ADJUST<A NAME="72"> </A>, and MENU<A NAME="73"> </A> when referencing the
mouse buttons. (If your mouse has three
buttons then these are usually the left, middle and right buttons,
respectively.)
<P>
Many of the functions of DsTool can be executed by using the keyboard
instead of the mouse.<A NAME="74"> </A> In general, pressing Tab
while the cursor points into a window will cause a panel item to be
highlighted with a black outline. Pressing Tab again will cause the
outline to switch to the next exclusive or non-exclusive setting, listbox,
scrollbar, button, or read-write text field. (See below for descriptions of
these panel items.) Pressing Return or Space in one of these
items will have different effects depending upon the type of button.
The following conventions and notation are used throughout:
<P>
<DL>
<DD><P>
<DT><STRONG>Window title:</STRONG>
<DD>The text located in the window header.
<DT><STRONG>Function:</STRONG>
<DD>A brief summary of the window's main purpose within DsTool.
<DT><STRONG>Description:</STRONG>
<DD>Instructions on how to open the window and a
detailed account of the window's behavior when the user
interacts with it.
<DT><STRONG>Panel items:</STRONG>
<DD>A complete listing of all items located on the window's
control panel, along with a brief description of each item's characteristics.
The terms used in this document are:
<UL>
<LI>Button: There are five types of buttons used in DsTool.
The first type of button is the <EM>command</EM><A NAME="82"> </A><A NAME="83"> </A>
button, which initiates an action when selected. Some actions are
potentially dangerous (, writing data to a file which already
exists) and such actions are accompanied by a <EM>notifier</EM><A NAME="85"> </A> which
requests confirmation. A command button has the command it will execute designated on its face.
The second type of button is the
<EM>window</EM><A NAME="87"> </A><A NAME="88"> </A> button which opens a pop-up
window when selected. A window button has the name of the pop-up window it will open
followed by ellipsis (...) marks designated on its face.
A third type of button is the <EM>command-window</EM><A NAME="90"> </A><A NAME="91"> </A>
button, which when selected first initiates an action, and then opens a pop-up window.
A command-window button has the command it will execute followed by ellipsis marks designated on its face.
The fourth type of button is the <EM>menu</EM> button<A NAME="93"> </A><A NAME="94"> </A>, which
displays a menu of options<A NAME="95"> </A><A NAME="96"> </A>
when SELECT is pressed while the pointer is on it.
A menu button is a flat button whose label has its first letter underlined.
The fifth type of button is the <EM>popup menu</EM><A NAME="98"> </A><A NAME="99"> </A>
button, which functions just like a menu button. A popup menu button
is a raised button with a thin rectangle at the far
right of its face. Popup menu buttons are usually used for stack settings.
Of these types of buttons, only command, command-window, and window buttons respond to
keyboard input. Pressing Space in one of these buttons is equivalent to
pressing the SELECT button. Pressing Return does nothing.
<BR>
<DIV ALIGN="CENTER"><A NAME="buttons"> </A><A NAME="134"> </A>
<TABLE WIDTH="50%">
<CAPTION><STRONG>Figure 2.1:</STRONG>
Five types of buttons.</CAPTION>
<TR><TD>3#3</TD></TR>
</TABLE>
</DIV>
<BR>
<LI>Text Fields:<A NAME="106"> </A> A text field is an area where numerical
or alphabetic information may be stored and displayed.
Most text fields are <EM>read-write</EM>, meaning that the
user may input information into them, but some text fields
are <EM>read-only</EM>. A text field which accepts only integer values is called a <EM> numeric</EM><A NAME="110"> </A> field. Read-write and numeric text fields can obtain
the focus of the cursor by using the Tab key. Pressing Return
while the focus is on a read-write text field will generally cause an update procedure
to be executed. Usually, this saves the appropriate variables for that window to
the Postmaster. In some cases, other window items will be updated to reflect new information.
<LI>Message:<A NAME="113"> </A> A message is similar to a text field. The
program uses messages to display information to the user. A message is always read-only.
<LI>Settings: A setting is a list of choices.
A <EM>non-exclusive</EM><A NAME="115"> </A><A NAME="116"> </A>
setting presents options which
may be chosen independently, such as selecting data to be saved into a file.
An <EM>exclusive</EM><A NAME="118"> </A><A NAME="119"> </A>
setting is a set of options which are mutually
exclusive, such as the choices ``on'' and ``off.''
Both exclusive and non-exclusive settings function the same way with respect to
keyboard input. Pressing Return or Space while the focus is
on a setting of these types will select the appropriate choice.
A third type of setting is called a <EM>stack</EM><A NAME="123"> </A><A NAME="124"> </A>
setting. It is
related to the exclusive setting in that only one option may be
selected from among the choices, but unlike the exclusive setting,
not all options are displayed at one time.
The currently selected option is displayed on the popup menu
button; all options may be viewed by clicking the button with SELECT.
Stack settings do not respond to keyboard input.
<LI>Listbox:<A NAME="125"> </A> A listbox is a box with a list of entries in it,
one or more of which may be selected by the user. Listboxes differ from exclusive
and non-exclusive settings by the fact that the choices may not be
completely independent or exclusive.
For example, a listbox may allow only two of its entries to be selected. Also,
the number of entries that can be selected in a listbox might change with the
value of another variable. Selected entries will appear
differently, usually with a raised gray background.
Pressing SELECT or Space will (de)select the entry that the mouse is pointing
to or the underlined entry, respectively. The underlined entry may be moved up or down with
the arrow keys. Pressing Return
will do nothing.
<LI>Text Pane:<A NAME="128"> </A> A text pane is a region in which the user may
read, write, and edit text. Some text panes are <EM>read-only</EM>.
</UL></DL><HR>
<!--Navigation Panel-->
<A NAME="tex2html640"
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html637"
HREF="node5.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html631"
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html639"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html641"
HREF="node7.html">The Command Window</A>
<B> Up:</B> <A NAME="tex2html638"
HREF="node5.html">Attributes of Interface Windows</A>
<B> Previous:</B> <A NAME="tex2html632"
HREF="node5.html">Attributes of Interface Windows</A>
<!--End of Navigation Panel-->
<ADDRESS>
<I>John Lapeyre</I>
<BR><I>1998-09-04</I>
</ADDRESS>
</BODY>
</HTML>
|
