Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: w32std.h

Enum TEventCode

TEventCode

Support

Supported from 5.0

Description

Types of standard events.

These are events that the window server passes to its clients — as opposed to events that the base passes to the window server.

EEventNull

Null event.This can be sent, but should be ignored by clients.

EEventKey

Key event. This is the event that is sent when a character has been received from the keyboard.When the user presses a key (other than the modifier keys), an EEventKeyDown event, and EEventKey event, and an EEventKeyUp event are generated in that order.

EEventKeyUp

Key up event. When the user presses a key (other than the modifier keys), an EEventKeyDown event, and EEventKey event, and an EEventKeyUp event are generated in that order.

EEventKeyDown

Key down event. When the user presses a key (other than the modifier keys), an EEventKeyDown event, and EEventKey event, and an EEventKeyUp event are generated in that order.

EEventModifiersChanged

Modifier changed event. This is an event generated by the window server when the state of one of the modifier keys changes. This event type is not reported unless explicitly requested by a window. See RWindowTreeNode::EnableModifierChangedEvents().

EEventPointer

Pointer event.This event is sent when the user presses or releases a pointer button (or the equivalent action, depending on the type of pointing device), drags the pointer, or uses the pointer to switch on the device. If the current input type (see TXYInputType) is "mouse" or "relative mouse" — i.e. it generates pointer move events as well as drag events — then this event type is also generated whenever the pointer is moved.

EEventPointerEnter

Pointer enter event.This occurs when the user moves the pointer into a window with a pointer button pressed (or equivalent action depending on the type of pointing device). If move events are being generated, this event also occurs when the user moves the pointer into the window.

EEventPointerExit

Pointer exit event.Occurs when the user moves the pointer out of a window with a pointer button pressed (or equivalent action depending on the type of pointing device). If move events are being generated, this event also occurs when the user moves the pointer out of the window.

EEventPointerBufferReady

Pointer move buffer ready event.Occurs when the pointer move buffer is ready to be retrieved by the client.

EEventDragDrop

Occurs as a duplicate of each pointer event if a window sets pointer capture with the TCaptureFlagDragDrop flag set.

EEventFocusLost

Drag drop event.Occurs when a window group loses keyboard focus.

EEventFocusGained

Focus gained event.Occurs when a window group gains keyboard focus.

EEventSwitchOn

On event. This event type is not reported unless explicitly requested by a window. See RWindowTreeNode::EnableOnEvents().

EEventPassword

Password event.Occurs when the window server enters password mode. It is sent to the group window of the currently active password window. This is the window server mode where the user is required to enter a password before any further actions can be performed.

EEventWindowGroupsChanged

Window group changed event. This occurs whenever a window group is destroyed, and whenever a window group's name changes This event type is not reported unless explicitly requested by a window. See RWindowTreeNode::EnableGroupChangeEvents().

EEventErrorMessage

Error event. Occurs when an error occurs. See TWsErrorMessage::TErrorCategory for the types of errors. This event type is not reported unless explicitly requested by a window. See RWindowTreeNode::EnableErrorMessages().

EEventMessageReady

Message ready event.Occurs when a session sends a message to this window group using RWsSession::SendMessageToWindowGroup().

EEventSwitchOff

Off event.This is issued when an off event is received by the window server from the base. If for some reason the event can't be delivered, or there is no-one to deliver them to, then a call to the base is made to power down the processor.This event is only delivered if explicitly requested using RWsSession:RequestOffEvent().

EEventKeySwitchOff

Off event issued to off-event requesting windows when the off key is pressed. This replaces EEventShellSwitchOff which was used prior to version 6.0.

EEventShellSwitchOff

Off event issued to the shell when the off key is pressed. This is replaced by EEventKeySwitchOff in version 6.0 because off events can now be issued to any window, rather than just the shell.

EEventScreenDeviceChanged

Screen size mode change event.This is issued, for example, if the screen size mode has changed, e.g. opening the flip on the Ericsson R380 smartphone.

EEventFocusGroupChanged

Event set whenever the focus window group changes. Requested by RWindowTreeNode::EnableFocusChangeEvents()

EEventCaseOpened

Case opened event. These events will be sent to those windows that have requested EEventSwitchOn events. Unlike with EEventSwitchOn events, the screen will not be switched on first.

EEventCaseClosed

Case closed events. These events will be sent to those windows that have requested EEventSwitchOff events. Unlike EEventSwitchOff events, which make a call to the base to power down the processor if for some reason the event can't be delivered (or there is no-one to deliver them to), failure to deliver case closed events has no repercussions.

EEventUser

User defined event. See RWs::SendEventToWindowGroup()The client is allowed to use this and all higher values to define their own events. These events can be sent between windows of the same client or windows of different clients.