~ubuntu-branches/ubuntu/utopic/tcm/utopic

« back to all changes in this revision

Viewing changes to lib/help/DiagramMouseCommands

  • Committer: Bazaar Package Importer
  • Author(s): Otavio Salvador
  • Date: 2003-07-03 20:08:21 UTC
  • Revision ID: james.westby@ubuntu.com-20030703200821-se4xtqx25e5miczi
Tags: upstream-2.20
ImportĀ upstreamĀ versionĀ 2.20

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
The following diagram edit commands are issued by using the mouse
 
2
and/or the keyboard in the drawing area. We have grouped them into 
 
3
creation commands, selection commands, text edit commands and movement 
 
4
commands.
 
5
 
 
6
 
 
7
 
 
8
CREATION COMMANDS.
 
9
==================
 
10
 
 
11
Create a node.
 
12
--------------
 
13
For creating a node, first choose the desired node type from the node 
 
14
tiles. Click button-1 in the background of the drawing area, at the 
 
15
desired position. A new node shape appears, having its center at the 
 
16
position where is clicked and having the shape as indicated by the 
 
17
selected node type in the tiles.
 
18
 
 
19
Create an edge.
 
20
---------------
 
21
To create a straight edge between two nodes, Drag with button-2 from 
 
22
a node to a node. This means you push and hold down button-2 somewhere 
 
23
inside the source node and move the mouse with button-2 still pushed 
 
24
down. 
 
25
 
 
26
To create a segmented edge, release button-2 in the background while 
 
27
you are dragging. Then the first intermediate point is created. After 
 
28
that, the line follows the mouse all by itself. Then you can add 
 
29
another intermediate point by clicking button-2 somewhere else in the 
 
30
background. You complete the edge by moving into the target node and 
 
31
clicking button-2.
 
32
 
 
33
To create a curved edge, set the Curve toggle in the tiled menu. The 
 
34
Bezier curve requires exactly two intermediate points, which makes four
 
35
edge points in total. These intermediate points are added in the same 
 
36
way as creating normal multiple line segments as described for 
 
37
segmented edges. When the four points are determined, a smooth curve is
 
38
drawn between the end points and the two intermediate points act as 
 
39
controlling points.
 
40
 
 
41
 
 
42
 
 
43
SELECTION COMMANDS.
 
44
==================
 
45
 
 
46
Select a single node or edge.
 
47
-----------------------------
 
48
Click button-1 on an unselected shape (node, edge). The selection will 
 
49
contain only this shape which will show black selection handles.
 
50
 
 
51
Select a part of the diagram.
 
52
-----------------------------
 
53
Drag button-1 starting in the background. The area that you are 
 
54
selecting, is enclosed by a stippled box, and its bottom-right corner 
 
55
is attached to the mouse. If you release button-1 then every shape 
 
56
that was (partly) inside the stippled box is selected and every other 
 
57
shape outside the box is unselected. One of these selected shapes will 
 
58
show black selection handles, the others will become grey.
 
59
 
 
60
Add a shape to the selection.
 
61
-----------------------------
 
62
Click button-2 on an unselected shape. The first selected shape will 
 
63
show black selection handles, the other selected shapes will show grey
 
64
selection handles.
 
65
 
 
66
Remove from the selection. 
 
67
--------------------------
 
68
Click button-2 on a selected shape. The selection handles disappear.
 
69
 
 
70
Empty the selection.
 
71
--------------------
 
72
Click button-2 somewhere in the background. All selection handles 
 
73
disappear.
 
74
 
 
75
Make selected shape first selected.
 
76
------------------------------------
 
77
You can enforce that a selected shape is the first selected by clicking
 
78
button-1 on an already selected (grey) shape. The selection handles of 
 
79
the old first selected shape will become grey and the handles
 
80
of the clicked shape will become black.
 
81
 
 
82
 
 
83
 
 
84
TEXT EDIT COMMANDS.
 
85
==================
 
86
 
 
87
Go into edit mode.
 
88
------------------
 
89
For getting into edit mode make sure that the shape with the label that
 
90
you want to edit is the only selected shape. When you move the mouse 
 
91
pointer into the single selected shape, the mouse pointer turns 
 
92
into I-shape. By clicking button-1 on the shape or typing the first
 
93
character you go into edit mode. 
 
94
 
 
95
There are two edit modes: in-line editing and out-line editing. In-line
 
96
editing takes place directly in the drawing area. Out-line editing 
 
97
takes place in a separate window with a text editor that is popped up 
 
98
when the edit mode is entered. You can indicate which of the two 
 
99
possible edit modes has to be used by a toggle button labeled in-line 
 
100
editor.
 
101
 
 
102
Edit text.
 
103
----------
 
104
In both in-line as the out-line editor you can type in any printable 
 
105
character as text and move the edit cursor around with the arrow 
 
106
buttons or by clicking with button-1 at the desired cursor position.
 
107
See the user manual for the more advanced text edit features.
 
108
 
 
109
Leave edit mode.
 
110
-----------------
 
111
From the in-line editor you leave edit mode by clicking button-1 
 
112
outside the shape that is being edited or by clicking button-2
 
113
at any position of the drawing area. The text that is edited will 
 
114
be updated, and when the autoresizing toggle is on, the shape will be
 
115
resized to make it fit the text that it contains. After the text is
 
116
updated, you can still undo the update including the autoresizing, 
 
117
by issuing the undo command from the Edit menu. 
 
118
 
 
119
 
 
120
 
 
121
MOVEMENT COMMANDS.
 
122
==================
 
123
 
 
124
Move one or more nodes.
 
125
-----------------------
 
126
You can move a node shape by positioning the mouse into that node and 
 
127
then drag it with button-1. The shape does not need to be selected. A 
 
128
grey node outline moves along with the mouse. If you release button-1 
 
129
then this node shape is redrawn at the new position and all its 
 
130
adjacent lines are redrawn too. You can also move the entire selection.
 
131
If you drag one of the selected node shapes, all other selected shapes 
 
132
are moved with over the same distance, including the line handles of 
 
133
the selected edges.
 
134
 
 
135
Moving an edge handle. 
 
136
----------------------
 
137
You can drag the individual handles of an edge. When an edge is 
 
138
selected and the mouse is in one of the handles, you can drag this 
 
139
handle with button-1 and a grey outline of the new line follows 
 
140
the mouse. You can move the intermediate handles of a line to an 
 
141
arbitrary place in the drawing area. When you drag and release one of 
 
142
the end point handles into the connected node or somewhere in the 
 
143
background, then the end point will be placed at the border of the 
 
144
connected node at a position that is the closest to the place where 
 
145
the handle was released.
 
146
 
 
147
Redirect an edge.
 
148
-----------------
 
149
When you drag an end point handle of an edge into a different node 
 
150
then the edge will be redirected to that node. The result is that the 
 
151
edge now connects to a different node.
 
152
 
 
153
Add an edge handle.
 
154
-------------------
 
155
You add an extra handle when you drag with button-1 from a segment
 
156
of an existing line. Where you release the button a new edge
 
157
handle is added to the line.
 
158
 
 
159
Remove an edge handle.
 
160
----------------------
 
161
You remove an intermediate handle when you click with button-2 on
 
162
a handle of a single-selected line.
 
163
 
 
164
Move the label of an edge.
 
165
--------------------------
 
166
You can move the label of an edge by dragging it with button-1. The 
 
167
edge need not be selected. You cannot move the label of a node; when 
 
168
you move or resize a node, the label positions inside the node are 
 
169
recalculated, as well as the labels of the adjacent edges.
 
170
 
 
171
Resize a node (from the center).
 
172
--------------------------------
 
173
Resizing a node shape is possible by dragging button-1 on one of the 
 
174
selection handles. The mouse pointer turns into one of the eight 
 
175
symbols that indicate to what direction the node shape can be resized.
 
176
With this operation the center of the node shape stays the same.
 
177
 
 
178
Resize a node (relocate its borders).
 
179
------------------------------------
 
180
Resizing a node shape is possible by dragging button-2 on one of the 
 
181
selection handles. The mouse pointer turns into one of the eight 
 
182
symbols that indicate to what direction the node shape can be resized.
 
183
With this operation the borders of node shape are moved.