author | HG Automerge |
Thu, 19 Jan 2017 12:00:14 +0000 | |
branch | jv |
changeset 3854 | 4afd107bc911 |
parent 3661 | c340d371658a |
permissions | -rw-r--r-- |
60 | 1 |
" |
2 |
COPYRIGHT (c) 1995 by Claus Gittinger |
|
77 | 3 |
All Rights Reserved |
60 | 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 |
" |
|
1424 | 12 |
"{ Package: 'stx:libview2' }" |
13 |
||
3661 | 14 |
"{ NameSpace: Smalltalk }" |
15 |
||
60 | 16 |
Object subclass:#EventListener |
212 | 17 |
instanceVariableNames:'' |
18 |
classVariableNames:'' |
|
19 |
poolDictionaries:'' |
|
2687 | 20 |
category:'Interface-Support-UI' |
60 | 21 |
! |
22 |
||
1173 | 23 |
!EventListener class methodsFor:'documentation'! |
60 | 24 |
|
123 | 25 |
copyright |
26 |
" |
|
27 |
COPYRIGHT (c) 1995 by Claus Gittinger |
|
28 |
All Rights Reserved |
|
29 |
||
30 |
This software is furnished under a license and may be used |
|
31 |
only in accordance with the terms of that license and with the |
|
32 |
inclusion of the above copyright notice. This software may not |
|
33 |
be provided or otherwise made available to, or used by, any |
|
34 |
other person. No title to or ownership of the software is |
|
35 |
hereby transferred. |
|
36 |
" |
|
37 |
||
38 |
||
60 | 39 |
! |
40 |
||
41 |
documentation |
|
42 |
" |
|
98 | 43 |
abstract class for event listeners. EventListeners can be used to intercept |
44 |
incoming events (keyboard & mouse) directly from a sensor, or even |
|
45 |
for a complete display device. |
|
574 | 46 |
A concrete application is the bubble help, which tracks entering/leaving |
47 |
views, and pops up some help message. |
|
48 |
See concrete code in ActiveHelp. |
|
49 |
||
98 | 50 |
For each intercepted event, a corresponding method is called for in instances |
574 | 51 |
of myself - these MUST return true, if the event is to be ignored (i.e. |
52 |
assumed to be processed and consumed by the reader, |
|
53 |
and MUST return false, if the normal event procedure should be performed. |
|
54 |
Since this is an abstract class, |
|
55 |
all of my intercept methods return false. |
|
56 |
They are meant to be redefined in concrete subclasses. |
|
212 | 57 |
|
58 |
[see also:] |
|
574 | 59 |
WindowSensor WindowEvent WindowGroup |
222 | 60 |
|
61 |
[author:] |
|
574 | 62 |
Claus Gittinger |
60 | 63 |
" |
64 |
! ! |
|
65 |
||
2390 | 66 |
!EventListener methodsFor:'event handling'! |
60 | 67 |
|
2476
7fa9e8576594
changed #buttonMotion:x:y:view:
Claus Gittinger <cg@exept.de>
parents:
2390
diff
changeset
|
68 |
buttonMotion:buttonAndModifierState x:x y:y view:aView |
574 | 69 |
"not handled here - should be redefined in a concrete subclass" |
213 | 70 |
|
60 | 71 |
^ false |
213 | 72 |
|
73 |
"Modified: 23.4.1996 / 21:57:54 / cg" |
|
60 | 74 |
! |
75 |
||
76 |
buttonMultiPress:button x:x y:y view:aView |
|
574 | 77 |
"not handled here - should be redefined in a concrete subclass" |
213 | 78 |
|
60 | 79 |
^ false |
80 |
||
213 | 81 |
"Modified: 23.4.1996 / 21:57:58 / cg" |
60 | 82 |
! |
83 |
||
84 |
buttonPress:button x:x y:y view:aView |
|
574 | 85 |
"not handled here - should be redefined in a concrete subclass" |
213 | 86 |
|
60 | 87 |
^ false |
88 |
||
213 | 89 |
"Modified: 23.4.1996 / 21:58:01 / cg" |
60 | 90 |
! |
91 |
||
123 | 92 |
buttonRelease:button x:x y:y view:aView |
574 | 93 |
"not handled here - should be redefined in a concrete subclass" |
213 | 94 |
|
60 | 95 |
^ false |
123 | 96 |
|
213 | 97 |
"Modified: 23.4.1996 / 21:58:03 / cg" |
60 | 98 |
! |
99 |
||
2516 | 100 |
focusInView:aView |
101 |
"not handled here - should be redefined in a concrete subclass" |
|
102 |
||
103 |
^ false |
|
104 |
! |
|
105 |
||
106 |
focusOutView:aView |
|
107 |
"not handled here - should be redefined in a concrete subclass" |
|
108 |
||
109 |
^ false |
|
110 |
! |
|
111 |
||
1424 | 112 |
hasKeyboardFocus:aBoolean view:aView |
113 |
"not handled here - should be redefined in a concrete subclass" |
|
114 |
||
115 |
^ false |
|
116 |
! |
|
117 |
||
3036 | 118 |
hotkeyWithId:aHotKeyId rawKey:theRawKey view: aView |
119 |
"not handled here - should be redefined in a concrete subclass" |
|
120 |
||
121 |
^ false |
|
122 |
||
123 |
"Modified: 23.4.1996 / 21:57:54 / cg" |
|
124 |
! |
|
125 |
||
123 | 126 |
keyPress:key x:x y:y view:aView |
574 | 127 |
"not handled here - should be redefined in a concrete subclass" |
213 | 128 |
|
123 | 129 |
^ false |
130 |
||
213 | 131 |
"Modified: 23.4.1996 / 21:58:08 / cg" |
123 | 132 |
! |
133 |
||
134 |
keyRelease:key x:x y:y view:aView |
|
574 | 135 |
"not handled here - should be redefined in a concrete subclass" |
213 | 136 |
|
60 | 137 |
^ false |
138 |
||
213 | 139 |
"Modified: 23.4.1996 / 21:58:11 / cg" |
60 | 140 |
! |
141 |
||
1178
44f1fee1b444
pass x/y with mouseWheel event
Claus Gittinger <cg@exept.de>
parents:
1176
diff
changeset
|
142 |
mouseWheelMotion:state x:x y:y amount:amount deltaTime:dTime view:aView |
1173 | 143 |
"not handled here - can be redefined in a concrete subclass" |
144 |
||
145 |
^ false |
|
146 |
||
147 |
"Modified: / 23.4.1996 / 21:57:54 / cg" |
|
148 |
"Created: / 21.5.1999 / 13:07:13 / cg" |
|
149 |
! |
|
150 |
||
60 | 151 |
pointerEnter:state x:x y:y view:view |
574 | 152 |
"not handled here - should be redefined in a concrete subclass" |
213 | 153 |
|
60 | 154 |
^ false |
155 |
||
213 | 156 |
"Modified: 23.4.1996 / 21:58:14 / cg" |
60 | 157 |
! |
158 |
||
123 | 159 |
pointerLeave:state view:view |
574 | 160 |
"not handled here - should be redefined in a concrete subclass" |
213 | 161 |
|
60 | 162 |
^ false |
163 |
||
213 | 164 |
"Modified: 23.4.1996 / 21:58:17 / cg" |
2390 | 165 |
! ! |
166 |
||
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
167 |
!EventListener methodsFor:'event handling-basic'! |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
168 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
169 |
processEvent:ev |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
170 |
"process an event; if true is returned, the event is considered to be |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
171 |
'eaten' by the listener, and not passed to the view. |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
172 |
If false is returned, the event is processed as usual. |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
173 |
Here, the event is dispatched into one of the button*/key* etc. methods" |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
174 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
175 |
"/ subclasses may do: |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
176 |
"/ |eventHasBeenProcessed| |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
177 |
"/ |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
178 |
"/ eventHasBeenProcessed := false. |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
179 |
"/ Error handle:[:ex | |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
180 |
"/ ('Listener [info]: error while processing event: ' , ex description) infoPrintCR. |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
181 |
"/ ] do:[ |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
182 |
"/ eventHasBeenProcessed := ev dispatchWithViewArgumentTo:self |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
183 |
"/ ]. |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
184 |
"/ ^ eventHasBeenProcessed |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
185 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
186 |
^ false |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
187 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
188 |
"Modified: / 29-06-2011 / 19:13:18 / cg" |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
189 |
! ! |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
190 |
|
2390 | 191 |
!EventListener methodsFor:'events-window creation'! |
1262 | 192 |
|
193 |
postCreateView:aView |
|
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
194 |
"a synthetic event: |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
195 |
some view was created" |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
196 |
|
1262 | 197 |
^ self |
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
198 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
199 |
"Modified: / 29-06-2011 / 18:55:53 / cg" |
1262 | 200 |
! |
201 |
||
202 |
preCreateView:aView |
|
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
203 |
"a synthetic event: |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
204 |
some view is about to be created; |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
205 |
gives me a chance to intercept and change size, origin, color, etc." |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
206 |
|
1262 | 207 |
^ self |
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
208 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
209 |
"Modified: / 29-06-2011 / 18:54:19 / cg" |
2390 | 210 |
! |
574 | 211 |
|
212 |
preCreateView:aView origin:org |
|
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
213 |
"Obsolete now - the system will now send a preCreateView: event (without origin arg). |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
214 |
not really an event: |
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
215 |
invoked right before a view is about to be physically created. |
574 | 216 |
May return a new origin." |
217 |
||
218 |
^ org |
|
2913
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
219 |
|
a3a577a77dc1
change to only expect one single method to be (re)defined:
Claus Gittinger <cg@exept.de>
parents:
2687
diff
changeset
|
220 |
"Modified: / 29-06-2011 / 18:55:23 / cg" |
574 | 221 |
! ! |
222 |
||
60 | 223 |
!EventListener methodsFor:'listen'! |
224 |
||
225 |
listen |
|
226 |
"install myself as listener" |
|
227 |
||
1262 | 228 |
WindowSensor addEventListener:self |
60 | 229 |
|
230 |
" |
|
231 |
|listener| |
|
232 |
||
233 |
listener := EventListener new. |
|
234 |
listener listen. |
|
235 |
(Delay forSeconds:20) wait. |
|
236 |
listener unlisten |
|
237 |
" |
|
238 |
! |
|
239 |
||
240 |
unlisten |
|
241 |
"uninstall myself as listener" |
|
242 |
||
1262 | 243 |
WindowSensor removeEventListener:self |
60 | 244 |
! ! |
123 | 245 |
|
3661 | 246 |
!EventListener class methodsFor:'documentation'! |
247 |
||
248 |
version_CVS |
|
249 |
^ '$Header$' |
|
250 |
! ! |
|
251 |