No enforcement.

All windows that are the children of window groups will be displayed, irrespective of the screen mode.

This is not properly supported and is provided for testing purposes.

Pixels and rotation enforcement.

Group windows must be set up for the correct rotation and be working in the correct size in pixels to be displayed.

Pixels and Twips enforcement.

Group windows must have the correct rotation and be working in the correct size in pixels and twips to be displayed.

This setting might be used if the display pixels are not square, and would distort fonts when rotated.

Square corner.

Corner pixel removed.

Two pixel step.

3 pixels are removed: the corner pixel and a single pixel from each side.

Three pixel step.

5 pixels are removed: the corner pixel, the two pixels next to it and the 2 pixels above or below it.

Five pixel step.

12 pixels are removed: the corner pixel, the four pixels next to it, the four pixels above or below it, the pixel which was diagonal to the corner pixel, and the pixels to both sides of that pixel.

Corner type mask.

This value is used by the window server, and may be used by developers, to separate TCornerType and TCornerFlags values from a TInt which contains both types.

Do not apply corner shape to top left corner.

Do not apply corner shape to top right corner.

Do not apply corner shape to bottom left corner.

Do not apply corner shape to bottom right corner.

Backup the area behind the current window only.

This is the default behaviour for the RWindowBase::EnableBackup(TUint) function.

Backup the entire screen.

This is provided for windows that require the rest of the screen to fade when they are displayed. When the rest of the screen should become unfaded, the window server redraws the whole screen from the backed up bitmap.

Null event.

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

Key event.

This is the event that is sent when a character has been received from the keyboard.

If an EEventKey event is associated with an EEventKeyDown or EEventKeyUp event (typically EEventKeyDown), the EEventKey event occurs after the EEventKeyDown/EEventKeyUp event.

In practice, the only keys potentially likely to have their EEventKey event generated on the up rather than the down are modifier keys.

Key up event.

If an EEventKey event is associated with an EEventKeyUp event (which is rarely the case), the EEventKey event occurs after the EEventKeyUp event.

Key down event.

If an EEventKey event is associated with an EEventKeyDown event (which is typically the case), the EEventKey event occurs after the EEventKeyDown event.

Modifier changed event.

This is an event generated by the window server when the state of one of the modifier keys changes. It is not reported unless explicitly requested by a window.

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.

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.

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.

Pointer move buffer ready event.

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

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

Focus lost event.

Occurs when a window group loses keyboard focus.

Focus gained event.

Occurs when a window group gains keyboard focus.

On event.

This event type is not reported unless explicitly requested by a window.

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.

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.

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.

Message ready event.

Occurs when a session sends a message to this window group using RWsSession::SendMessageToWindowGroup(TInt,TUid,const TDesC8 &).

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 it to, then a call to the base is made to power down the processor.

This event is only delivered if explicitly requested using RWsSessionRWsSession:RequestOffEvent().

Event issued to off-event requesting windows when the off key is pressed.

Screen size mode change event.

This is issued when the screen size mode has changed, for instance when the cover on a phone that supports screen flipping is opened or closed.

Event sent whenever the window group with focus changes.

Requested by RWindowTreeNode::EnableFocusChangeEvents().

Case opened event.

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

Case closed event.

This event is 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 it to), failure to deliver case closed events has no repercussions.

Window group list change event.

The window group list is a list of all window groups and their z-order. This event indicates any change in the window group list: additions, removals and reorderings.

Notification of this event is requested by calling RWindowTreeNode::EnableGroupListChangeEvents().

The visibility of a window has changed

This is sent to windows when they change from visible to invisible, or visa versa, usually due to another window obscuring them.

Notification of this event is requested by calling RWindowTreeNode::EnableVisibilityChangeEvents().

Repeating key event.

This is only sent to a key click plug-in DLL (if one is present) to indicate a repeating key event.

Direct screen access begin This is only sent to anim dlls (if they register to be notified). It indicates that the number of direct screen access sessions has increased from zero to one.

Direct screen access end This is only sent to anim dlls (if they register to be notified). It indicates that the number of direct screen access sessions has decreased from one to zero.

Event to signal the starting or stopping of the wserv heartbeat timer This is only sent to anim dlls (if they register to be notified).

900-909 WSERV protects with PowerMgmt

UserUser defined event.

The client can 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.

Enables logging of all messages to and from the window server.

Note that the required type of logging must have been specified in the wsini.ini file (using the LOG keyword), and the appropriate logging DLL must be available.

Default key mapping: <Ctrl><Alt><Shift>E

Always disables window server logging, if active. Does nothing otherwise.

Default key mapping: <Ctrl><Alt><Shift>D

Dumps a list of all windows to the log. (If logging is disabled, it is temporarily enabled in order to do this.)

Default key mapping: <Ctrl><Alt><Shift>W

Kills the foreground application.

Default key mapping: <Ctrl><Alt><Shift>K

Shuts down the window server.

Be cautious! This may mean resetting the machine to re-start the window server.

Default key mapping: release (not available), debug (<Ctrl><Alt><Shift>X).

Dumps a list of cells allocated on the window server's heap to the log. (If logging is disabled, it is temporarily enabled in order to do this.)

Note that logging requires that the type of logging has been set up in the wsini.ini file, and that the appropriate logging DLL is available.

Default key mapping: <Ctrl><Alt><Shift>H

Increases the LCD contrast.

Default key mapping: EKeyIncContrast. Note that this value is from an enum in e32keys.h. The contrast wraps around when it reaches the maximum.

Decreases the LCD contrast.

Default key mapping: EKeyDecContrast. Note that this value is from an enum in e32keys.h. The contrast wraps around when it reaches the minimum.

Switches the machine off.

Default key mapping: EKeyOff. Note that this value is from an enum in e32keys.h.

Switches the backlight on.

Default key mapping: EKeyBacklightOn. Note that this value is from an enum in e32keys.h.

Switches the backlight off.

Default key mapping: EKeyBacklightOff. Note that this value is from an enum in e32keys.h.

Toggles the backlight.

Default key mapping: EKeyBacklightToggle. Note that this value is from an enum in e32keys.h.

Switches to screen size 0.

This, and the following 3 keys are used to switch screen sizes on real hardware, for instance when the cover is closed on a phone that supports screen flipping.

Switches to screen size 1.

This might be generated when the cover is opened on a phone that supports screen flipping.

Switches to screen size 2.

Switches to screen size 3.

Cycles the display though its possible sizes.

This is used only for debugging.

A device may have several screen sizes, each with a default orientation. For example a phone that supports screen flipping will have different display sizes when the cover is opened and closed.

Default key mapping: debug : <Ctrl><Alt><Shift> U. Release : none.

Cycles the screen orientation through the specified rotations for the particular size mode you are in.

For example, phones that support screen flipping may use this feature for changing between right and left handed use.

For rectangular display modes you can only specify 2 orientations, 180 degrees apart. For square modes you can specify 4 rotations (90 degrees) or however many you want.

Specification of the list of rotations takes place in the WSINI.INI file.

Default key mapping: debug : <Ctrl><Alt><Shift> O. Release : none.

Increases the screen's brightness.

The brightness wraps around to the minimum value after it has reached the maximum.

Decreases the screen's brightness.

The brightness wraps around to the maximum value after it has reached the minimum.

Cycle focus screen from one to another in multiple screen environment. Start from current focused screen, switch to next the screen, and wraps around when it reaches the last screen.

Default key mapping: <Ctrl><Alt><Shift> I.

Value for first hot key.

Used with EHotKeyLastKeyType to make it easy to write a for loop that steps through all the different key values.

Value for last hot key.

Used with EHotKeyFirstKeyType to make it easy to write a for loop that steps through all the different key values.

Releases ownership of password handling.

This allows another window to become the password window. A client will be panicked with code 46 if it sets this mode when it is not the current password window.

No password handling is performed by this window, but no other window can become the password window.

Password mode is enabled only once a day.

When enabled, password mode requires the user to enter a password before any further actions can be performed.

Password mode is enabled every time the machine is switched on.

Equivalent to setting the password mode to EPasswordAlways and triggering an instant password check.

Equivalent to setting the password mode to EPasswordOnceADay and triggering an instant password check.

Flash sprite on and off.

All flashing is done on the same timer, including the text cursor.

With this flag set, the sprite is displayed over the window and all its children.

Without the flag, the sprite is only displayed over the window's visible area.

This is particularly useful when the sprite is owned by a window group, as it means the sprite will be displayed over the whole screen.

Notes:

By default a sprite is clipped to the visible region of the window that owns it.

Sprites with this flag set are displayed in front of sprites without this flag.

The sprite's appearance will not change when it is on a shadowed part of the screen.

(Typically this is used for sprites attached to window groups so that they are perceived to be floating above the windows).

Requested events are sent in all circumstances.

Events are delivered only when the requesting window's window group has keyboard focus.

Events are delivered only when the requesting window or any of its children are visible on the screen.

Filters out both pointer enter and pointer exit events for this window.

Filters out pointer-move events for this window.

Filters out pointer-drag events for this window.

Simulates a pointer move event before each pen down event.

This makes the pen appear more like a mouse, with simulated movement between two pointer events. You can only get these events while you are in pen mode.

Filters move and drag-pointer events from the event stream and simulates the move event before each pen down event.

This enum is useful when you want to get simulated move events. Use it as shown below to turn on simulated moves:

    win->PointerFilter(EPointerMoveEvents, EPointerGenerateSimulateMoves)

Don't have a pointer cursor.

The default system pointer cursor is used whenever there is a pointer cursor.

The default system pointer cursor is used unless the window the pointer cursor is above specifies one, in which case that cursor is used.

There is no pointer cursor unless the pointer is above a window that has specified one.

First pointer cursor mode.

This is used in test code for iterating though available modes.

The final pointer cursor mode.

This is used in test code for iterating though available modes. It will be updated if more modes are added.

If specified, the normal ("short") key event is sent immediately (on key down) to the application with keyboard focus. If not specified, the normal key event is sent when the key is released (if the key is not held down long enough to generate a long key event).

If specified, causes the long key press to automatically repeat. If not specified, the long key press will generate a single key event only.

Equivalent to ELongCaptureShortEventImmediately being set and the other flags unset.

Equivalent to the first two values being unset.

Default behaviour.

Freeze the content of underneath the transparent window to prevent redraw everytime the overlying window changes.