In this context, a general event is any kind of event that is generated by the Window Server and delivered to the client, with the exception of redraw and priority key events.
Variant: ScreenPlay and non-ScreenPlay. Target audience: Application developers.
All events generated by the Window Server, except redraw events and priority key events, are delivered to the client in a TWsEvent which is requested asynchronously by the RWsSession::EventReady() function. When this request completes, it is handled by an active object CActive::RunL() function which must use RWsSession::GetEvent() to get the TWsEvent representing the event. The TWsEvent::Type() function is used to identify the event type which can then retrieve the appropriate type of data.
The following table lists for each event type returned by TWsEvent::Type(), what object TWsEvent::EventData() returns, and what the TWsEvent::Handle() represents.
TWsEvent::Type() |
TWsEvent::EventData() |
TWsEvent::Handle() |
n/a |
n/a |
|
RWindowGroup client handle |
||
RWindowGroup client handle |
||
RWindowGroup client handle |
||
The client handle of the RWindowTreeNode on which EnableModifierChangedEvents() was called. |
||
RWindow client handle |
||
RWindow client handle |
||
RWindow client handle |
||
None - call RWindowBase::RetrievePointerMoveBuffer() |
RWindow client handle |
|
RWindow client handle |
||
None |
RWindowGroup client handle |
|
None |
RWindowGroup client handle |
|
None |
The client handle of the RWindowTreeNode on which EnableOnEvents() was called. |
|
None |
The client handle of the RWindowGroup of the window on which PasswordWindow() was called. |
|
None |
The client handle of the RWindowTreeNode on which RWindowTreeNode::EnableGroupChangeEvents() was called. |
|
The client handle of the RWindowTreeNode on which EnableErrorMessages() was called. |
||
None |
RWindowGroup client handle |
|
n/a |
n/a |
|
None |
The client handle of the RWindowTreeNode passed into RWsSession::RequestOffEvents(). |
|
None |
The client handle of the RWindowTreeNode passed into RWsSession::RequestOffEvents(). |
|
None |
The client handle of the object on which RWindowGroup::EnableScreenChangeEvents() was called. |
|
The client handle of the CWsScreenDevice object on which MDisplayControl:: EnableDisplayChangeEvents() was called. See Display Control and Mapping in the Window Server Client for more information. |
||
None |
The client handle of the RWindowTreeNode on which EnableFocusChangeEvents() was called. |
|
The client handle of the RWindowTreeNode on which EnableVisibilityChangeEvents() was called. |
||
None |
The client handle of the RWindowTreeNode on which EnableOnEvents() was called. |
|
None |
The client handle of the RWindowTreeNode passed into RWsSession::RequestOffEvents(). |
|
None |
The client handle of the RWindowTreeNode on which EnableGroupListChangeEvents() was called. |
|
n/a (only sent to the key click plug-in interface) |
n/a |
|
n/a |
n/a |