EventListener.st
author Claus Gittinger <cg@exept.de>
Tue, 23 Apr 1996 21:58:32 +0200
changeset 213 9fac751c6499
parent 212 874afdeb380a
child 222 c51b06f6bf9a
permissions -rw-r--r--
commentary
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     1
"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
77
claus
parents: 60
diff changeset
     3
	      All Rights Reserved
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     4
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    11
"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    12
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    13
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    14
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    15
Object subclass:#EventListener
212
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    16
	instanceVariableNames:''
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    17
	classVariableNames:''
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    18
	poolDictionaries:''
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    19
	category:'Interface-Support'
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    20
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    21
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    22
!EventListener class methodsFor:'documentation'!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    23
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    24
copyright
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    25
"
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    26
 COPYRIGHT (c) 1995 by Claus Gittinger
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    27
	      All Rights Reserved
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    28
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    29
 This software is furnished under a license and may be used
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    30
 only in accordance with the terms of that license and with the
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    32
 be provided or otherwise made available to, or used by, any
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    33
 other person.  No title to or ownership of the software is
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    34
 hereby transferred.
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    35
"
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    36
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    37
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    38
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    39
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    40
documentation
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    41
"
98
claus
parents: 96
diff changeset
    42
    abstract class for event listeners. EventListeners can be used to intercept
claus
parents: 96
diff changeset
    43
    incoming events (keyboard & mouse) directly from a sensor, or even
claus
parents: 96
diff changeset
    44
    for a complete display device.
claus
parents: 96
diff changeset
    45
    One application is the automatic help, which tracks entering/leaving
claus
parents: 96
diff changeset
    46
    views, to popup some help message. See concrete code in ActiveHelp.
claus
parents: 96
diff changeset
    47
    For each intercepted event, a corresponding method is called for in instances
claus
parents: 96
diff changeset
    48
    of myself - these should return true, if the event is to be ignored (i.e.
claus
parents: 96
diff changeset
    49
    assumed to be processed and consumed by the reader, or false, if the normal
claus
parents: 96
diff changeset
    50
    event procedure should be performed. Since this is an abstract class,
claus
parents: 96
diff changeset
    51
    all of my intercept methods return false. They are meant to be redefined
claus
parents: 96
diff changeset
    52
    in concrete subclasses.
212
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    53
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    54
    [see also:]
874afdeb380a commentary
Claus Gittinger <cg@exept.de>
parents: 127
diff changeset
    55
        WindowSensor WindowEvent WindowGroup
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    56
"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    57
! !
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    58
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    59
!EventListener methodsFor:'events'!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    60
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    61
buttonMotion:state x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    62
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    63
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    64
    ^ false
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    65
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    66
    "Modified: 23.4.1996 / 21:57:54 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    67
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    68
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    69
buttonMultiPress:button x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    70
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    71
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    72
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    73
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    74
    "Modified: 23.4.1996 / 21:57:58 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    75
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    76
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    77
buttonPress:button x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    78
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    79
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    80
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    81
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    82
    "Modified: 23.4.1996 / 21:58:01 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    83
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    84
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    85
buttonRelease:button x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    86
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    87
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    88
    ^ false
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    89
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    90
    "Modified: 23.4.1996 / 21:58:03 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    91
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    92
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    93
buttonShiftPress:button x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    94
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    95
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    96
    ^ false
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    97
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
    98
    "Modified: 23.4.1996 / 21:58:06 / cg"
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    99
!
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   100
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   101
keyPress:key x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   102
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   103
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   104
    ^ false
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   105
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   106
    "Modified: 23.4.1996 / 21:58:08 / cg"
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   107
!
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   108
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   109
keyRelease:key x:x y:y view:aView
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   110
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   111
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   112
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   113
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   114
    "Modified: 23.4.1996 / 21:58:11 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   115
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   116
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   117
pointerEnter:state x:x y:y view:view
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   118
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   119
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   120
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   121
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   122
    "Modified: 23.4.1996 / 21:58:14 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   123
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   124
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   125
pointerLeave:state view:view
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   126
    "not handled here - should be redefined in a concrete subclas"
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   127
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   128
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   129
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   130
    "Modified: 23.4.1996 / 21:58:17 / cg"
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   131
! !
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   132
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   133
!EventListener methodsFor:'listen'!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   134
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   135
listen
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   136
    "install myself as listener"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   137
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   138
    WindowSensor eventListener:self
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   139
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   140
    "
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   141
     |listener|
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   142
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   143
     listener := EventListener new.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   144
     listener listen.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   145
     (Delay forSeconds:20) wait.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   146
     listener unlisten
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   147
    "
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   148
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   149
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   150
unlisten
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   151
    "uninstall myself as listener"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   152
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   153
    WindowSensor eventListener:nil 
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   154
! !
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   155
127
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   156
!EventListener class methodsFor:'documentation'!
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   157
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   158
version
213
9fac751c6499 commentary
Claus Gittinger <cg@exept.de>
parents: 212
diff changeset
   159
    ^ '$Header: /cvs/stx/stx/libview2/EventListener.st,v 1.10 1996-04-23 19:58:32 cg Exp $'
127
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   160
! !