EventListener.st
author Claus Gittinger <cg@exept.de>
Tue, 20 Feb 1996 19:24:36 +0100
changeset 163 80f4fe3bcc71
parent 127 4b1051c23b9b
child 212 874afdeb380a
permissions -rw-r--r--
care for interrupts while adding/removing dependents
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
77
claus
parents: 60
diff changeset
    16
	 instanceVariableNames:''
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    17
	 classVariableNames:''
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    18
	 poolDictionaries:''
77
claus
parents: 60
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.
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    53
"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    54
! !
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    55
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    56
!EventListener methodsFor:'events'!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    57
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    58
buttonMotion:state x:x y:y view:aView
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    59
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    60
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    61
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    62
buttonMultiPress:button x:x y:y view:aView
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    63
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    64
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    65
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    66
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    67
buttonPress:button x:x y:y view:aView
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    68
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    69
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    70
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    71
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    72
buttonRelease:button x:x y:y view:aView
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    73
    ^ false
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    74
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    75
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    76
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    77
buttonShiftPress:button x:x y:y view:aView
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    78
    ^ false
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    79
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    80
!
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    81
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    82
keyPress:key x:x y:y view:aView
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    83
    ^ false
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    84
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    85
!
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    86
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    87
keyRelease:key x:x y:y view:aView
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    88
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    89
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    90
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    91
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    92
pointerEnter:state x:x y:y view:view
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    93
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    94
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    95
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    96
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
    97
pointerLeave:state view:view
60
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    98
    ^ false
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
    99
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   100
! !
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   101
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   102
!EventListener methodsFor:'listen'!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   103
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   104
listen
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   105
    "install myself as listener"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   106
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   107
    WindowSensor eventListener:self
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   108
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   109
    "
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   110
     |listener|
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   111
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   112
     listener := EventListener new.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   113
     listener listen.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   114
     (Delay forSeconds:20) wait.
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   115
     listener unlisten
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   116
    "
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   117
!
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   118
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   119
unlisten
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   120
    "uninstall myself as listener"
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   121
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   122
    WindowSensor eventListener:nil 
c9dc64d2b4d6 Initial revision
claus
parents:
diff changeset
   123
! !
123
39e9679c132d checkin from browser
Claus Gittinger <cg@exept.de>
parents: 114
diff changeset
   124
127
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   125
!EventListener class methodsFor:'documentation'!
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   126
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   127
version
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   128
    ^ '$Header: /cvs/stx/stx/libview2/EventListener.st,v 1.8 1995-11-23 17:45:14 cg Exp $'
4b1051c23b9b checkin from browser
Claus Gittinger <cg@exept.de>
parents: 123
diff changeset
   129
! !