WSensor.st
changeset 598 1a2339e902d4
parent 581 23dc2352dce9
child 608 3370e1f983d4
--- a/WSensor.st	Tue Apr 23 21:41:54 1996 +0200
+++ b/WSensor.st	Tue Apr 23 21:57:07 1996 +0200
@@ -61,9 +61,9 @@
     a so-called 'eventListener' to get the event before it is entered into
     the queue. There are 3 possible listening hooks available:
 
-	a global EventListener - gets keybd/mouse events for all views
-	a per-sensor eventListener - gets only keybd/mouse events for this sensors wGroup
-	a per-sensor keyboardListener - only gets keyboard events for this sensors wGroup
+        a global EventListener - gets keybd/mouse events for all views
+        a per-sensor eventListener - gets only keybd/mouse events for this sensors wGroup
+        a per-sensor keyboardListener - only gets keyboard events for this sensors wGroup
 
     (actually, there are two more mechanisms, event delegation which allows
      delegation of key- and buttonEvents of a specific view,
@@ -87,85 +87,91 @@
     Read the documentation in WindowEvent for more info.
 
 
-    instance variables:
-	eventSemaphore          <Semaphore>     the semaphore to be signalled when an event
-						(or damage) arrives
+    [instance variables:]
+        eventSemaphore          <Semaphore>     the semaphore to be signalled when an event
+                                                (or damage) arrives
 
-	damage                  <Collection>    collection of damage events
+        damage                  <Collection>    collection of damage events
 
-	mouseAndKeyboard        <Collection>    collection of user events
+        mouseAndKeyboard        <Collection>    collection of user events
 
-	compressMotionEvents    <Boolean>       if true, multiple motion events are
-						compressed to one event. If false, each
-						event is handled individual.
-						(should be set to false when doing free-hand drawing)
+        compressMotionEvents    <Boolean>       if true, multiple motion events are
+                                                compressed to one event. If false, each
+                                                event is handled individual.
+                                                (should be set to false when doing free-hand drawing)
 
-	ignoreUserInput         <Boolean>       if true, key & button events are ignored
-						(usually set to true by WindowGroup, while a
-						 modalbox covers a view)
+        ignoreUserInput         <Boolean>       if true, key & button events are ignored
+                                                (usually set to true by WindowGroup, while a
+                                                 modalbox covers a view)
 
-	shiftDown               <Boolean>       true while shift/meta/control-key is pressed
-	metaDown                                (to support ST-80 style query: sensor shiftDown)
-	ctrlDown
-	altDown                                 (notice, that on most systems, alt and meta key is
-						 the same, both reported as #Alt)
+        shiftDown               <Boolean>       true while shift/meta/control-key is pressed
+        metaDown                                (to support ST-80 style query: sensor shiftDown)
+        ctrlDown
+        altDown                                 (notice, that on most systems, alt and meta key is
+                                                 the same, both reported as #Alt)
 
-	exposeEventSemaphore    <Semaphore>     X-special: semaphore to be signalled when
-						expose event arrives after a copyArea.
+        exposeEventSemaphore    <Semaphore>     X-special: semaphore to be signalled when
+                                                expose event arrives after a copyArea.
 
-	catchExpose             <Boolean>       true, while waiting for an expose event 
-						(after a copyArea)
+        catchExpose             <Boolean>       true, while waiting for an expose event 
+                                                (after a copyArea)
 
-	gotExpose               <Boolean>       set to true, when an expose event arrives
-						(after a copyarea)
+        gotExpose               <Boolean>       set to true, when an expose event arrives
+                                                (after a copyarea)
 
-	gotOtherEvent           <Boolean>       set to true if other events arrive while
-						waiting for expose (after a copyarea).
+        gotOtherEvent           <Boolean>       set to true if other events arrive while
+                                                waiting for expose (after a copyarea).
 
-	translateKeyboardEvents <Boolean>       if true, keyboard events are translated via
-						the devices leyboardMap; if false, they
-						are reported as raw-keys. Default is true.
+        translateKeyboardEvents <Boolean>       if true, keyboard events are translated via
+                                                the devices leyboardMap; if false, they
+                                                are reported as raw-keys. Default is true.
 
-	eventListener           <Object>        if non nil, this one will get all pointer
-						and keyboard events for this sensors views first.
-						If it returns true, the event is supposed to
-						be already handled by the listener and not sent to
-						the view. If false, the event is handled as usual.
-						This allows applications to catch events for any of
-						its views.
+        eventListener           <Object>        if non nil, this one will get all pointer
+                                                and keyboard events for this sensors views first.
+                                                If it returns true, the event is supposed to
+                                                be already handled by the listener and not sent to
+                                                the view. If false, the event is handled as usual.
+                                                This allows applications to catch events for any of
+                                                its views.
 
-	keyboardListener        <Object>        if non nil, this one will get all keyboard events 
-						for this sensors views first (but after the eventListener,
-						if any).
-						If it returns true, the event is supposed to
-						be already handled by the listener and not sent to
-						the view. If false, the event is handled as usual.
-						This allows applications to catch events for any of
-						its views.
-						ApplicationModels can catch keyboard input with:
-						    postOpenWith:aBuilder
-							aBuilder window sensor keyboardListener:self
+        keyboardListener        <Object>        if non nil, this one will get all keyboard events 
+                                                for this sensors views first (but after the eventListener,
+                                                if any).
+                                                If it returns true, the event is supposed to
+                                                be already handled by the listener and not sent to
+                                                the view. If false, the event is handled as usual.
+                                                This allows applications to catch events for any of
+                                                its views.
+                                                ApplicationModels can catch keyboard input with:
+                                                    postOpenWith:aBuilder
+                                                        aBuilder window sensor keyboardListener:self
 
 
-    class variables:
+    [class variables:]
 
-	ControlCEnabled         <Boolean>       if true (which is the default) Control-C
-						will interrupt the process handling the
-						view.
-						For secure stand-alone applications,
-						this can be set to false, in which case 
-						Control-C does NOT interrupt the process.
+        ControlCEnabled         <Boolean>       if true (which is the default) Control-C
+                                                will interrupt the process handling the
+                                                view.
+                                                For secure stand-alone applications,
+                                                this can be set to false, in which case 
+                                                Control-C does NOT interrupt the process.
 
-	EventListener           <Object>        if non nil, this one will get all pointer
-						and keyboard events for ALL views first.
-						If it returns true, the event is supposed to
-						be already handled by the listener and not enqueued. 
-						If false, the event is handled as usual.
-						This allows overall event catchers to be
-						installed for example to implement event
-						recorders, active help managers etc.
+        EventListener           <Object>        if non nil, this one will get all pointer
+                                                and keyboard events for ALL views first.
+                                                If it returns true, the event is supposed to
+                                                be already handled by the listener and not enqueued. 
+                                                If false, the event is handled as usual.
+                                                This allows overall event catchers to be
+                                                installed for example to implement event
+                                                recorders, active help managers etc.
 
-	ComposeTable            <Array>         compose-key translation table
+        ComposeTable            <Array>         compose-key translation table
+
+
+    [see also:]
+        WindowGroup 
+        WindowEvent KeyboardMap KeyboardForwarder EventListener
+        DeviceWorkstation View
 "
 ! !
 
@@ -1792,6 +1798,6 @@
 !WindowSensor class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libview/Attic/WSensor.st,v 1.51 1996-04-22 14:23:27 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libview/Attic/WSensor.st,v 1.52 1996-04-23 19:56:32 cg Exp $'
 ! !
 WindowSensor initialize!