author | Claus Gittinger <cg@exept.de> |
Fri, 28 Feb 1997 19:54:00 +0100 | |
changeset 1395 | 7218ca27d752 |
parent 1152 | 21c666e130dd |
child 1500 | d70af951e8b4 |
permissions | -rw-r--r-- |
0 | 1 |
" |
6 | 2 |
COPYRIGHT (c) 1989 by Claus Gittinger |
72 | 3 |
All Rights Reserved |
0 | 4 |
|
5 |
This software is furnished under a license and may be used |
|
6 |
only in accordance with the terms of that license and with the |
|
7 |
inclusion of the above copyright notice. This software may not |
|
8 |
be provided or otherwise made available to, or used by, any |
|
9 |
other person. No title to or ownership of the software is |
|
10 |
hereby transferred. |
|
11 |
" |
|
12 |
||
135 | 13 |
SimpleView subclass:#View |
1146
0167191529dd
moved menuHolder/menuPerformer up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
621
diff
changeset
|
14 |
instanceVariableNames:'model aspectMsg changeMsg menuMsg menuHolder menuPerformer' |
616 | 15 |
classVariableNames:'' |
16 |
poolDictionaries:'' |
|
17 |
category:'Views-Basic' |
|
0 | 18 |
! |
19 |
||
2 | 20 |
!View class methodsFor:'documentation'! |
41 | 21 |
|
46 | 22 |
copyright |
23 |
" |
|
24 |
COPYRIGHT (c) 1989 by Claus Gittinger |
|
72 | 25 |
All Rights Reserved |
46 | 26 |
|
27 |
This software is furnished under a license and may be used |
|
28 |
only in accordance with the terms of that license and with the |
|
29 |
inclusion of the above copyright notice. This software may not |
|
30 |
be provided or otherwise made available to, or used by, any |
|
31 |
other person. No title to or ownership of the software is |
|
32 |
hereby transferred. |
|
33 |
" |
|
34 |
! |
|
35 |
||
41 | 36 |
documentation |
2 | 37 |
" |
135 | 38 |
this class adds provisions for views which show or work on a model. |
39 |
This functionality used to be in View, but has been extracted into SimpleView and |
|
40 |
this new View class, to take some of the stuff out of views which do not need |
|
41 |
this functionality (i.e. all views which do only geometry management). |
|
82 | 42 |
Instances of View are seldom used, most views in the system inherit |
43 |
from this class. |
|
41 | 44 |
|
616 | 45 |
[Instance variables:] |
46 |
model <nil | any> the model (if any) |
|
41 | 47 |
|
616 | 48 |
aspectMsg <nil | Symbol> the aspect; typically |
49 |
dependentViews react on changes |
|
50 |
of this aspect and update their contents. |
|
51 |
||
52 |
changeMsg <nil | Symbol> the changeMessage; typically |
|
53 |
dependentViews send this message to |
|
54 |
the model to tell it about changes. |
|
140 | 55 |
|
616 | 56 |
menuMsg <nil | Symbol> the menuMessage; typically |
57 |
dependentViews send this message to |
|
58 |
the model to ask for a popup menu. |
|
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
59 |
|
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
60 |
|
1152
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
61 |
menuHolder <any> who has a menu |
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
62 |
(default: nil i.e. model has menu) |
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
63 |
|
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
64 |
menuPerformer <any> who performs menu actions |
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
65 |
(default: nil i.e. model has menu) |
616 | 66 |
|
67 |
[see also:] |
|
621 | 68 |
StandardSystemView TopView DialogBox |
616 | 69 |
WindowGroup |
621 | 70 |
Model ValueHolder |
616 | 71 |
( introduction to view programming :html: programming/viewintro.html ) |
72 |
||
140 | 73 |
|
616 | 74 |
[author:] |
75 |
Claus Gittinger |
|
76 |
" |
|
77 |
! |
|
78 |
||
79 |
examples |
|
80 |
" |
|
81 |
a subView in a topView: |
|
621 | 82 |
[exBegin] |
616 | 83 |
|top v| |
140 | 84 |
|
616 | 85 |
topView := StandardSystemView new. |
86 |
v := View new. |
|
87 |
v origin:0.25 @ 0.25 corner:0.75 @ 0.75. |
|
88 |
top addSubView:v. |
|
89 |
top open |
|
621 | 90 |
[exEnd] |
616 | 91 |
|
92 |
||
93 |
the same, a bit more compact: |
|
621 | 94 |
[exBegin] |
616 | 95 |
|top v| |
96 |
||
97 |
topView := StandardSystemView new. |
|
98 |
v := View origin:0.25 @ 0.25 corner:0.75 @ 0.75 in:topView. |
|
99 |
top open |
|
621 | 100 |
[exEnd] |
101 |
||
2 | 102 |
" |
103 |
! ! |
|
0 | 104 |
|
118 | 105 |
!View class methodsFor:'instance creation'! |
106 |
||
140 | 107 |
on:aModel aspect:aspectMsg |
108 |
"st-80 style view creation: create a new view, set its model |
|
109 |
and selectors for aspect" |
|
110 |
||
111 |
^ self new |
|
112 |
on:aModel |
|
113 |
aspect:aspectMsg |
|
114 |
! |
|
115 |
||
116 |
on:aModel aspect:aspectMsg change:changeMsg |
|
117 |
"st-80 style view creation: create a new view, set its model |
|
118 |
and selectors for aspect and change" |
|
119 |
||
120 |
^ self new |
|
121 |
on:aModel |
|
122 |
aspect:aspectMsg |
|
123 |
change:changeMsg |
|
124 |
! |
|
125 |
||
135 | 126 |
on:aModel aspect:aspectMsg change:changeMsg menu:menuMsg |
118 | 127 |
"st-80 style view creation: create a new view, set its model |
140 | 128 |
and selectors for aspect, change and menu" |
118 | 129 |
|
135 | 130 |
^ self new |
131 |
on:aModel |
|
132 |
aspect:aspectMsg |
|
133 |
change:changeMsg |
|
134 |
menu:menuMsg |
|
118 | 135 |
! |
136 |
||
269 | 137 |
on:aModel aspect:aspectMsg menu:menuMsg |
138 |
"st-80 style view creation: create a new view, set its model |
|
139 |
and selectors for aspect and menu" |
|
118 | 140 |
|
269 | 141 |
^ self new |
142 |
on:aModel |
|
143 |
aspect:aspectMsg |
|
144 |
menu:menuMsg |
|
118 | 145 |
! ! |
146 |
||
123 | 147 |
!View class methodsFor:'defaults'! |
148 |
||
140 | 149 |
defaultAspectMessage |
135 | 150 |
"subclasses which by default do NOT want to be informed about changed |
151 |
models should redefine this to return nil" |
|
118 | 152 |
|
135 | 153 |
^ #value |
0 | 154 |
! |
155 |
||
140 | 156 |
defaultChangeMessage |
135 | 157 |
"subclasses which by default do NOT want to inform the model |
158 |
should redefine this to return nil" |
|
0 | 159 |
|
135 | 160 |
^ #value: |
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
161 |
! |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
162 |
|
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
163 |
defaultMenuMessage |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
164 |
"subclasses which by default do NOT want to send menu messages |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
165 |
should return nil" |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
166 |
|
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
167 |
^ nil |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
168 |
|
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
169 |
"Created: 3.1.1997 / 01:50:36 / stefan" |
0 | 170 |
! ! |
171 |
||
170 | 172 |
!View methodsFor:'accessing-channels'! |
173 |
||
174 |
setupChannel:newChannel for:changeSelector withOld:oldChannel |
|
175 |
"common code to change a channel" |
|
176 |
||
177 |
|oldValue| |
|
178 |
||
179 |
oldChannel notNil ifTrue:[ |
|
321
f31da2a1d387
interest is written with one 'r' (shame on me)
Claus Gittinger <cg@exept.de>
parents:
269
diff
changeset
|
180 |
oldChannel retractInterestsFor:self. |
170 | 181 |
oldValue := oldChannel value. |
182 |
]. |
|
183 |
newChannel onChangeSend:changeSelector to:self. |
|
184 |
self perform:changeSelector. |
|
185 |
^ newChannel |
|
186 |
! ! |
|
187 |
||
269 | 188 |
!View methodsFor:'accessing-menus'! |
189 |
||
190 |
menuHolder |
|
191 |
"who has the menu ? |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
192 |
If no explicit menuHolder was defined, its the model if I have one. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
193 |
Otherwise, its the menuHolder (if nonNil) or mySelf. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
194 |
The menuHolder is supposed to return a popUpMenu when asked via the |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
195 |
menuMessage." |
269 | 196 |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
197 |
menuHolder notNil ifTrue:[^ menuHolder]. |
269 | 198 |
model notNil ifTrue:[^ model]. |
199 |
^ self |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
200 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
201 |
"Modified: 23.12.1996 / 13:56:55 / cg" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
202 |
! |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
203 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
204 |
menuHolder:anObject |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
205 |
"change the one that provides the menu (via menuMsg)." |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
206 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
207 |
menuHolder := anObject |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
208 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
209 |
"Created: 23.12.1996 / 13:54:33 / cg" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
210 |
! |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
211 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
212 |
menuMessage |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
213 |
"Return the symbol sent to the model to aquire the menu" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
214 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
215 |
^ menuMsg |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
216 |
! |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
217 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
218 |
menuMessage:aSymbol |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
219 |
"ST-80 style menus: If a views menuSymbol is nonNil, it |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
220 |
will send it to its model when the middleButton is pressed. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
221 |
That method should return nil or the menu to be shown. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
222 |
This is useful for very dynamic menus, where it does not |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
223 |
make sense to define an initial menu. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
224 |
This is the same as #menu: which was added for ST-80 compatibility." |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
225 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
226 |
menuMsg := aSymbol |
269 | 227 |
! |
228 |
||
229 |
menuPerformer |
|
230 |
"who should perform the menu actions ? |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
231 |
If no menuPerformer was defined, its the model if I have one. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
232 |
Otherwise its the menuPerformer (if nonNil), or myself. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
233 |
The menuPerformer get messages from the menu" |
269 | 234 |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
235 |
menuPerformer notNil ifTrue:[^ menuPerformer]. |
269 | 236 |
model notNil ifTrue:[^ model]. |
237 |
^ self |
|
1147
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
238 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
239 |
"Modified: 23.12.1996 / 13:57:18 / cg" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
240 |
! |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
241 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
242 |
menuPerformer:anObject |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
243 |
"change the one that does the menu actions. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
244 |
See the comment in SimpleView>>activateMenu on who gets the menus |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
245 |
message." |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
246 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
247 |
menuPerformer := anObject |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
248 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
249 |
" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
250 |
|top textV plug| |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
251 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
252 |
plug := Plug new. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
253 |
plug respondTo:#textMenu |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
254 |
with:[ |m| |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
255 |
m := PopUpMenu |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
256 |
labels:#('copy' 'foo' '-' 'others') |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
257 |
selectors:#(copySelection foo nil others). |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
258 |
m subMenuAt:#others |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
259 |
put:(PopUpMenu |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
260 |
labels:#('bar' 'goto') |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
261 |
selectors:#(bar gotoLine)) |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
262 |
]. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
263 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
264 |
top := StandardSystemView new. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
265 |
top extent:300@300. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
266 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
267 |
textV := TextView origin:0.0@0.0 corner:1.0@1.0 in:top. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
268 |
textV menuHolder:plug; menuMessage:#textMenu; menuPerformer:plug. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
269 |
textV contents:'hello world'. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
270 |
top open. |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
271 |
" |
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
272 |
|
83ed804938e7
moved menuHolder/menuPerformer stuff up in the hierarchy
Claus Gittinger <cg@exept.de>
parents:
1146
diff
changeset
|
273 |
"Created: 23.12.1996 / 13:57:28 / cg" |
269 | 274 |
! ! |
275 |
||
118 | 276 |
!View methodsFor:'accessing-mvc'! |
277 |
||
269 | 278 |
addModelInterfaceTo:aDictionary |
279 |
"this adds entries for all messages sent to my model |
|
280 |
to aDictionary" |
|
281 |
||
282 |
aDictionary at:#aspectMessage put:aspectMsg. |
|
283 |
aDictionary at:#changeMessage put:changeMsg. |
|
284 |
aDictionary at:#menuMessage put:menuMsg. |
|
285 |
||
286 |
" |
|
287 |
Button new modelInterface |
|
288 |
" |
|
289 |
! |
|
135 | 290 |
|
269 | 291 |
aspect |
292 |
"Return the aspect used with changes from/to the model" |
|
293 |
||
294 |
^ aspectMsg |
|
295 |
! |
|
296 |
||
297 |
aspectMessage |
|
298 |
"Return the aspect used with changes from/to the model" |
|
299 |
||
300 |
^ aspectMsg |
|
301 |
! |
|
302 |
||
303 |
aspectMessage:aspectSymbol |
|
304 |
"ST-80 style updating: If a views aspectSymbol is nonNil, |
|
305 |
it will respond to changes of this aspect from the model." |
|
306 |
||
307 |
aspectMsg := aspectSymbol |
|
135 | 308 |
! |
309 |
||
269 | 310 |
change:changeSymbol |
311 |
"ST-80 style change notification: If a views changeSymbol is nonNil, |
|
312 |
it will send it to its model when something changes. |
|
313 |
Alias for changeMessage: for ST-80 compatibility." |
|
314 |
||
315 |
self changeMessage:changeSymbol |
|
316 |
! |
|
317 |
||
318 |
changeMessage |
|
319 |
"Return the symbol sent to the model if nonNil when something changes." |
|
135 | 320 |
|
269 | 321 |
^ changeMsg |
322 |
! |
|
323 |
||
324 |
changeMessage:aSymbol |
|
325 |
"ST-80 style change notification: If a views changeSymbol is nonNil, |
|
326 |
it will send it to its model when something changes. |
|
327 |
This is the same as change: which was added for ST-80 compatibility." |
|
328 |
||
329 |
changeMsg := aSymbol |
|
330 |
! |
|
331 |
||
332 |
controller:aController |
|
333 |
"set the controller" |
|
118 | 334 |
|
269 | 335 |
super controller:aController. |
336 |
controller notNil ifTrue:[ |
|
337 |
controller model:model |
|
0 | 338 |
] |
339 |
! |
|
340 |
||
269 | 341 |
menu:menuSymbol |
342 |
"ST-80 style menus: If a views menuSymbol is nonNil, it |
|
343 |
will send it to its model when the middleButton is pressed. |
|
344 |
That method should return nil or the menu to be shown. |
|
345 |
This is useful for very dynamic menus, where it does not |
|
346 |
make sense to define an initial menu. |
|
347 |
Alias for #menuMessage:, for ST-80 compatibility." |
|
348 |
||
349 |
menuMsg := menuSymbol |
|
350 |
! |
|
351 |
||
118 | 352 |
model |
353 |
"return the model, for non-MVC views, |
|
354 |
this is nil or the receiver" |
|
355 |
||
356 |
^ model |
|
357 |
! |
|
358 |
||
359 |
model:aModel |
|
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
360 |
"Set the model. |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
361 |
Here, if I am my own menuPerformer/menuHolder, |
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
362 |
set the menuHolder and menuPerformer to the model. |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
363 |
This is a compatibility kludge, |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
364 |
since typically, ST-80 code expects the model to provide a menu |
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
365 |
and perform it. If the model does not support a menu message, |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
366 |
it will be forwarded to the view. |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
367 |
Those apps which want the view to provide the (default) menu have to reset |
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
368 |
this by sending #menuHolder: message (again)" |
118 | 369 |
|
370 |
model notNil ifTrue:[ |
|
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
371 |
model removeDependent:self |
89 | 372 |
]. |
118 | 373 |
model := aModel. |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
374 |
(menuPerformer == self and:[menuHolder == self]) ifTrue:[ |
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
375 |
menuPerformer := menuHolder := model |
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
376 |
]. |
118 | 377 |
model notNil ifTrue:[ |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
378 |
aModel addDependent:self |
118 | 379 |
]. |
380 |
controller notNil ifTrue:[ |
|
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
381 |
controller model:aModel |
1395
7218ca27d752
moved class>.model to superClass.
Claus Gittinger <cg@exept.de>
parents:
1152
diff
changeset
|
382 |
]. |
1149
a3a75ffb29ce
Set meuPerformer also, when model is set.
Stefan Vogel <sv@exept.de>
parents:
1147
diff
changeset
|
383 |
|
1395
7218ca27d752
moved class>.model to superClass.
Claus Gittinger <cg@exept.de>
parents:
1152
diff
changeset
|
384 |
"Modified: 28.2.1997 / 19:23:06 / cg" |
118 | 385 |
! |
386 |
||
140 | 387 |
modelInterface |
388 |
"this returns a dictionary of messages sent to my model. |
|
389 |
It can be used for builders and wrappers to get information |
|
390 |
about the messages sent to my model. |
|
391 |
The returned dictionary contains one entry for each get-Msg, |
|
392 |
and the recevier will implement corresponding messages (with a colon) |
|
393 |
to set the message symbol." |
|
394 |
||
395 |
|d| |
|
396 |
||
397 |
d := IdentityDictionary new. |
|
398 |
self addModelInterfaceTo:d. |
|
399 |
^ d |
|
400 |
||
401 |
" |
|
402 |
Button new modelInterface |
|
403 |
Label new modelInterface |
|
404 |
" |
|
405 |
||
406 |
" |
|
407 |
does the view support setting the menuMessage ? |
|
408 |
||
409 |
SelectionInListView new modelInterface includesKey:#menuMessage |
|
410 |
" |
|
411 |
||
412 |
" |
|
413 |
turn off all interaction to the model: |
|
414 |
||
415 |
|m v if| |
|
416 |
||
417 |
m := SelectionInList new. |
|
418 |
m list:#('one' 'two' 'tree' 'four') asValue. |
|
419 |
m selection:1 asValue. |
|
420 |
v := SelectionInListView on:m. |
|
421 |
v open. |
|
422 |
v inspect. |
|
423 |
||
424 |
if := v modelInterface. |
|
425 |
if inspect. |
|
426 |
||
427 |
if keysAndValuesDo:[:what :msg | |
|
428 |
v perform:(what , ':') asSymbol with:nil. |
|
429 |
]. |
|
430 |
" |
|
269 | 431 |
! |
432 |
||
433 |
on:aModel aspect:aspectSymbol |
|
434 |
"ST-80 compatibility: set model and aspect |
|
435 |
messages - needs a view which uses these" |
|
436 |
||
437 |
aspectMsg := aspectSymbol. |
|
438 |
self model:aModel. |
|
439 |
! |
|
440 |
||
441 |
on:aModel aspect:aspectSymbol change:changeSymbol |
|
442 |
"ST-80 compatibility: set model, aspect and change |
|
443 |
messages - needs a view which uses these" |
|
444 |
||
445 |
aspectMsg := aspectSymbol. |
|
446 |
changeMsg := changeSymbol. |
|
447 |
self model:aModel. |
|
448 |
! |
|
449 |
||
450 |
on:aModel aspect:aspectSymbol change:changeSymbol menu:menuSymbol |
|
451 |
"ST-80 compatibility: set model, aspect, change and menu |
|
452 |
messages - needs a view which uses these" |
|
453 |
||
454 |
aspectMsg := aspectSymbol. |
|
455 |
changeMsg := changeSymbol. |
|
456 |
menuMsg := menuSymbol. |
|
457 |
self model:aModel. |
|
458 |
! |
|
459 |
||
460 |
on:aModel aspect:aspectSymbol menu:menuSymbol |
|
461 |
"ST-80 compatibility: set model, aspect and menu |
|
462 |
messages - needs a view which uses these" |
|
463 |
||
464 |
aspectMsg := aspectSymbol. |
|
465 |
menuMsg := menuSymbol. |
|
466 |
self model:aModel. |
|
467 |
! |
|
468 |
||
469 |
sendChangeMessage:aSelector with:arg |
|
470 |
"tell the model about a change" |
|
471 |
||
472 |
|n selector| |
|
473 |
||
474 |
"/ |
|
475 |
"/ MVC way of doing it: |
|
476 |
"/ if the model is a block, evaluate it, optionally |
|
477 |
"/ passing the arg and the receiver as arguments. |
|
478 |
"/ |
|
479 |
"/ otherwise (the common case) send it a changeMsg message |
|
480 |
"/ also with arg and the receiver (depending on the number of arguments |
|
481 |
"/ as defined by the selector). |
|
482 |
"/ |
|
483 |
(model notNil and:[aSelector notNil]) ifTrue:[ |
|
484 |
n := aSelector numArgs. |
|
485 |
model isBlock ifTrue:[ |
|
486 |
n := model numArgs. |
|
487 |
n == 0 ifTrue:[ |
|
488 |
selector := #value |
|
489 |
] ifFalse:[ |
|
490 |
n == 1 ifTrue:[ |
|
491 |
selector := #value: |
|
492 |
] ifFalse:[ |
|
493 |
selector := #value:value: |
|
494 |
] |
|
495 |
] |
|
496 |
] ifFalse:[ |
|
497 |
selector := aSelector |
|
498 |
]. |
|
499 |
n == 0 ifTrue:[ |
|
500 |
model perform:selector |
|
501 |
] ifFalse:[ |
|
502 |
n == 1 ifTrue:[ |
|
503 |
model perform:selector with:arg |
|
504 |
] ifFalse:[ |
|
505 |
model perform:selector with:arg with:self |
|
506 |
] |
|
507 |
] |
|
508 |
] |
|
509 |
! |
|
510 |
||
511 |
sendChangeMessageWith:arg |
|
512 |
"tell the model about a change" |
|
513 |
||
514 |
self sendChangeMessage:changeMsg with:arg |
|
72 | 515 |
! ! |
516 |
||
269 | 517 |
!View methodsFor:'drawing'! |
118 | 518 |
|
269 | 519 |
redraw |
520 |
"redraw myself |
|
521 |
if there is a model, this one shall redraw itself, |
|
522 |
otherwise we cannot do much here - has to be redefined in subclasses" |
|
118 | 523 |
|
269 | 524 |
model notNil ifTrue:[ |
525 |
model update:self |
|
526 |
] |
|
118 | 527 |
! ! |
528 |
||
529 |
!View methodsFor:'initialization'! |
|
530 |
||
531 |
initialize |
|
532 |
super initialize. |
|
140 | 533 |
|
534 |
aspectMsg := self class defaultAspectMessage. |
|
535 |
changeMsg := self class defaultChangeMessage. |
|
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
536 |
menuMsg := self class defaultMenuMessage. |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
537 |
|
135 | 538 |
model notNil ifTrue:[ |
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
539 |
controller notNil ifTrue:[ |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
540 |
controller model:model |
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
541 |
] |
81 | 542 |
]. |
1151
1a3682212ea9
Move rest of menuHolder/menuPerformer stuff to view.
Stefan Vogel <sv@exept.de>
parents:
1149
diff
changeset
|
543 |
|
1152
21c666e130dd
menuHolder/menuPerformer stuff.
Stefan Vogel <sv@exept.de>
parents:
1151
diff
changeset
|
544 |
"Modified: 3.1.1997 / 02:11:15 / stefan" |
118 | 545 |
! ! |
546 |
||
547 |
!View methodsFor:'realization'! |
|
548 |
||
549 |
destroy |
|
550 |
"unrealize & destroy - make me invisible, destroy subviews then |
|
551 |
make me unknown to the device" |
|
552 |
||
553 |
model notNil ifTrue:[ |
|
554 |
model removeDependent:self. |
|
555 |
model := nil. |
|
556 |
]. |
|
557 |
super destroy. |
|
558 |
! ! |
|
269 | 559 |
|
560 |
!View class methodsFor:'documentation'! |
|
561 |
||
562 |
version |
|
1395
7218ca27d752
moved class>.model to superClass.
Claus Gittinger <cg@exept.de>
parents:
1152
diff
changeset
|
563 |
^ '$Header: /cvs/stx/stx/libview/View.st,v 1.57 1997-02-28 18:54:00 cg Exp $' |
269 | 564 |
! ! |