A handle to a node in the server-side window tree. More...

#include <w32std.h>

Inheritance diagram for RWindowTreeNode:

Public Types
enum	TFadeControl { EFadeIncludeChildren =ETrue , EFadeWindowOnly =EFalse }
	Fade control flags. More...

Public Member Functions
IMPORT_C void	Close ()
	Closes the node.

IMPORT_C void	Destroy ()
	Closes and deletes the node.

IMPORT_C TUint32	ClientHandle () const
	Gets the window's client handle.

IMPORT_C TUint32	Parent () const
	Gets the node's parent.

IMPORT_C TUint32	PrevSibling () const
	Gets the node before this one in the sibling list.

IMPORT_C TUint32	NextSibling () const
	Gets the next window after this one in its sibling list.

IMPORT_C TUint32	Child () const
	Gets the first child of the node.

IMPORT_C TInt	OrdinalPriority () const
	Gets the ordinal priority of the specified window.

IMPORT_C TInt	OrdinalPosition () const
	Gets the current ordinal position of the window tree node.

IMPORT_C TInt	FullOrdinalPosition () const
	Get the current full ordinal position of a window.

IMPORT_C void	SetOrdinalPosition (TInt aPos)
	Sets the ordinal position of a window.

IMPORT_C void	SetOrdinalPosition (TInt aPos, TInt aOrdinalPriority)
	Sets the ordinal position and ordinal priority of a window.

IMPORT_C TInt	ScreenNumber () const
	Get the screen number that a window is located on.

IMPORT_C TInt	WindowGroupId () const
	Returns the window group Id of the parent window group.

IMPORT_C TInt	SetPointerCursor (TInt aCursorNumber)
	Sets the pointer cursor from the system pointer cursor list.

IMPORT_C void	SetCustomPointerCursor (const RWsPointerCursor &aPointerCursor)
	Sets the pointer cursor to an application-defined cursor.

IMPORT_C TInt	EnableOnEvents (TEventControl aCircumstances=EEventControlOnlyWithKeyboardFocus)
	Requests notification of 'on' events.

IMPORT_C void	DisableOnEvents ()
	Cancels notification of 'on' events.

IMPORT_C TInt	EnableGroupChangeEvents ()
	Requests notification of group-change events.

IMPORT_C void	DisableGroupChangeEvents ()
	Cancels notification of group changed events.

IMPORT_C TInt	EnableFocusChangeEvents ()
	Enables focus changed events.

IMPORT_C void	DisableFocusChangeEvents ()
	Disables delivery of focus changed events.

IMPORT_C TInt	EnableGroupListChangeEvents ()
	Enables reporting of window group list change events.

IMPORT_C void	DisableGroupListChangeEvents ()
	Disables reporting of window group list change events.

IMPORT_C TInt	EnableVisibilityChangeEvents ()
	Enables reporting of window visibility change events.

IMPORT_C void	DisableVisibilityChangeEvents ()
	Disables reporting of window visibility change events.

IMPORT_C TInt	EnableErrorMessages (TEventControl aCircumstances)
	Requests notification of error message events.

IMPORT_C void	DisableErrorMessages ()
	Cancels notification of error message events.

IMPORT_C TInt	EnableModifierChangedEvents (TUint aModifierMask, TEventControl aCircumstances)
	Requests notification of modifier changed events.

IMPORT_C void	DisableModifierChangedEvents ()
	Cancels notification of modifier changed events.

IMPORT_C void	SetNonFading (TBool aNonFading)
	Sets whether a window is non-fading.

IMPORT_C void	SetFaded (TBool aFaded, TFadeControl aIncludeChildren)
	Sets the window as faded or unfaded.

IMPORT_C void	SetFaded (TBool aFaded, TFadeControl aIncludeChildren, TUint8 aBlackMap, TUint8 aWhiteMap)
	Sets one or more windows as faded or unfaded, specifying a fading map.

IMPORT_C void	ClearPointerCursor ()
	Clears pointer cursor settings.

IMPORT_C RWsSession *	Session () const
	Returns the window server session that is used to create this window handle.

Public Member Functions inherited from MWsClientClass
	MWsClientClass ()

	MWsClientClass (RWsBuffer *aBuffer)

TInt	WsHandle () const
	Gets the server side handle for the object.

Protected Member Functions
	RWindowTreeNode ()
	Protected default constructor.

	RWindowTreeNode (RWsSession &aWs)
	Protected constructor which creates an uninitialised window tree node handle within a server session.

Protected Member Functions inherited from MWsClientClass
void	Write (const TAny *aData1, TInt aLength1, TInt aLength2, TUint aOpcode) const

void	Write (const TAny aData, TInt aLength, const TAny aData2, TInt aLength2, TUint aOpcode, const TIpcArgs *aIpcArgs=NULL) const

void	Write (const TAny aBuf, TInt aBufLen, TUint aOpcode, const TIpcArgs aIpcArgs=NULL) const

void	Write (TUint aOpcode) const

void	WriteInt (TInt aInt, TUint aOpcode) const

void	WriteRect (const TRect &aRect, TUint aOpcode) const

void	WritePoint (const TPoint &aPoint, TUint aOpcode) const

void	WriteSize (const TSize &aSize, TUint aOpcode) const

TInt	WriteReply (TUint aOpcode, const TIpcArgs *aIpcArgs=NULL) const

TInt	WriteReplyInt (TInt aInt, TUint aOpcode, const TIpcArgs *aIpcArgs=NULL) const

TInt	WriteReply (const TAny aBuf, TInt aBufLen, TUint aOpcode, const TIpcArgs aIpcArgs=NULL) const

TInt	WriteReply (const TAny aBuf, TInt aBufLen, const TAny aBuf2, TInt aBuflen2, TUint aOpcode, const TIpcArgs *aIpcArgs=NULL) const

TInt	WriteReplyP (const TWriteDescriptorType &aReplyPackage, TUint aOpcode) const

TInt	WriteReplyIntP (TInt aInt, const TWriteDescriptorType &aReplyPackage, TUint aOpcode) const

TInt	WriteReplyP (const TAny *aBuf, TInt aBufLen, const TWriteDescriptorType &aReplyPackage, TUint aOpcode) const

TInt	WriteReplyP (const TAny aBuf, TInt aBufLen, const TAny aBuf2, TInt aBuflen2, const TWriteDescriptorType &aReplyPackage, TUint aOpcode) const

TInt	WriteReplyByProvidingRemoteReadAccess (const TAny *aBuf, TInt aBufLen, const TReadDescriptorType &aRemoteReadBuffer, TUint aOpcode) const

void	AddToBitmapArray (const TInt aBitmapHandle) const

void	AsyncRequest (TRequestStatus &aStatus, TUint aOpcode) const

TBool	WindowSizeCacheEnabled () const

void	MarkWindowSizeCacheDirty ()

void	RefreshWindowSizeCache (const TSize &aNewSize) const

TInt	CachedWindowSize (TSize &aSize) const

void	DestroyWindowSizeCacheEntry ()

Protected Attributes
	__DECLARE_TEST

Protected Attributes inherited from MWsClientClass
TInt32	iWsHandle
	WARNING: Member variable for internal use ONLY.

RWsBuffer *	iBuffer
	WARNING: Member variable for internal use ONLY.

Friends
class	RWindowGroup

class	RWindowBase

class	CWindowGc

class	RAnimDll

class	RWsSprite

Detailed Description

A handle to a node in the server-side window tree.

This handle class is used as the base for both window groups and the windows within them; it is not intended for user derivation, and may not be directly constructed: use one of the standard derived classes instead.

API status: Published to all clients. Released API.

Definition at line 1652 of file w32std.h.

Member Enumeration Documentation

◆ TFadeControl

enum RWindowTreeNode::TFadeControl

Fade control flags.

These flags define whether fading is applied to all child windows when SetFaded() is called on a window.

Enumerator

EFadeIncludeChildren

Include all child windows when fading/un-fading.

EFadeWindowOnly

Fade only the parent window.

Note that a panic will occur if this value is used when SetFaded() is called
on a window group.

Definition at line 1674 of file w32std.h.

Constructor & Destructor Documentation

◆ RWindowTreeNode() [1/2]

RWindowTreeNode::RWindowTreeNode ( )

protected

Protected default constructor.

This creates a sessionless, uninitialised window tree node handle. This class is not for user derivation; however derived classes form part of the Window Server API.

Because RWindowTreeNode and its derived classes are lightweight handles, if your class contains an object of such a class, the object should be an inline member rather than a pointer member.

This default constructor allows you to instantiate such an inline member before the class that contains it has created a window server session. If you do this, you will need to call the RWindowTreeNode constructor that takes an RWsSession parameter before you can use the member, because RWindowTreeNode-derived objects must have a reference to a window server session in order to be valid.

(generated from Symbian Developer Library)

◆ RWindowTreeNode() [2/2]

RWindowTreeNode::RWindowTreeNode ( RWsSession & aWs )

protected

Protected constructor which creates an uninitialised window tree node handle within a server session.

This class is not for user derivation; however derived classes form part of the standard Window Server API, and are constructed with a public constructor with the same signature as this one.

Parameters

aWs	Window server session.

(generated from Symbian Developer Library)

Member Function Documentation

◆ Child()

IMPORT_C TUint32 RWindowTreeNode::Child ( ) const

Gets the first child of the node.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ ClearPointerCursor()

IMPORT_C void RWindowTreeNode::ClearPointerCursor ( )

Clears pointer cursor settings.

These are the settings made by calling SetPointerCursor().

(generated from Symbian Developer Library)

◆ ClientHandle()

IMPORT_C TUint32 RWindowTreeNode::ClientHandle ( ) const

Gets the window's client handle.

The return value is the client's integer handle that was passed as an argument to the window's Construct() function: see RWindow::Construct() for a description of the client handle.

This function always causes a flush of the window server buffer.

RWindow::Construct()

(generated from Symbian Developer Library)

◆ Close()

IMPORT_C void RWindowTreeNode::Close ( )

Closes the node.

This function should be called on all windows once they are no longer needed. It causes the window server to destroy the server-side window, and frees client-side resources owned by the window.

Note: When Close() is called on a parent window, its children are disconnected from the window tree and are hence removed from the screen. However, any client-side resources owned by its children are not freed. To free these resources, Close() (or Destroy()) must be called on all its children individually.

(generated from Symbian Developer Library)

◆ Destroy()

IMPORT_C void RWindowTreeNode::Destroy ( )

Closes and deletes the node.

This function calls Close() followed by delete on the window. Use this function only when the window is allocated in its own heap cell.

(generated from Symbian Developer Library)

◆ DisableErrorMessages()

IMPORT_C void RWindowTreeNode::DisableErrorMessages ( )

Cancels notification of error message events.

Use this function to instruct the server to stop reporting error message events to this window. If the window server has not previously been instructed to report error message events, this function has no effect (i.e. the default is that windows do not get error messages).

EnableErrorMessages()

(generated from Symbian Developer Library)

◆ DisableFocusChangeEvents()

IMPORT_C void RWindowTreeNode::DisableFocusChangeEvents ( )

Disables delivery of focus changed events.

Use this function to instruct the server to stop reporting window group focus changed events to this window. If the window server has not previously been instructed to report window group changed events, this function has no effect (i.e. the default is that windows do not get the events).

EnableFocusChangeEvents()

(generated from Symbian Developer Library)

◆ DisableGroupChangeEvents()

IMPORT_C void RWindowTreeNode::DisableGroupChangeEvents ( )

Cancels notification of group changed events.

Use this function to instruct the server to stop reporting window group changed events to this window. If the window server has not previously been instructed to report window group changed events, this function has no effect (i.e. the default is that windows do not get the events).

EnableGroupChangeEvents()

(generated from Symbian Developer Library)

◆ DisableGroupListChangeEvents()

IMPORT_C void RWindowTreeNode::DisableGroupListChangeEvents ( )

Disables reporting of window group list change events.

This function instructs the window server to stop sending window group list change events to this window. If the window server has not previously been instructed to report window group list change events, this function has no effect (i.e. the default is that windows do not receive group list change events).

(generated from Symbian Developer Library)

◆ DisableModifierChangedEvents()

IMPORT_C void RWindowTreeNode::DisableModifierChangedEvents ( )

Cancels notification of modifier changed events.

Use this function to instruct the server to stop reporting modifier changed events to this window. If the window server has not previously been instructed to report modifier changed events, this function has no effect (i.e. the default is that windows do not get the events).

EnableModifierChangedEvents()

(generated from Symbian Developer Library)

◆ DisableOnEvents()

IMPORT_C void RWindowTreeNode::DisableOnEvents ( )

Cancels notification of 'on' events.

This function instructs the server to stop reporting 'on' events to this window. If the window server has not previously been instructed to report 'on' events, this method has no effect (i.e. the default is that windows do not get the events).

EnableOnEvents()

(generated from Symbian Developer Library)

◆ DisableVisibilityChangeEvents()

IMPORT_C void RWindowTreeNode::DisableVisibilityChangeEvents ( )

Disables reporting of window visibility change events.

This function instructs the window server to stop sending window visibility change events to this window. If the window server has not previously been instructed to report window visibility change events, this function has no effect (i.e. the default is that windows do not receive visibility change events).

(generated from Symbian Developer Library)

◆ EnableErrorMessages()

IMPORT_C TInt RWindowTreeNode::EnableErrorMessages ( TEventControl aCircumstances )

Requests notification of error message events.

Use this function to instruct the window server to report error message events (of type EEventErrorMessage).

This function always causes a flush of the window server buffer.

DisableErrorMessages()

Parameters

aCircumstances The circumstances in which error message events are to be reported.

(generated from Symbian Developer Library)

◆ EnableFocusChangeEvents()

IMPORT_C TInt RWindowTreeNode::EnableFocusChangeEvents ( )

Enables focus changed events.

After this function is called, the EEventFocusGroupChanged event is delivered to the window server message queue every time the focus window group changes. The handle of the event is set to the client handle of the window that this function is called on.

This function always causes a flush of the window server buffer.

DisableFocusChangeEvents()

(generated from Symbian Developer Library)

◆ EnableGroupChangeEvents()

IMPORT_C TInt RWindowTreeNode::EnableGroupChangeEvents ( )

Requests notification of group-change events.

Use this function to instruct the window server to report group-change events to this window. These events will typically be of interest to a shell or similar application, for example to notify it that it should update its list of running applications. Window group changed events are of type EEventWindowGroupsChanged.

This function always causes a flush of the window server buffer.

DisableGroupChangeEvents()

(generated from Symbian Developer Library)

◆ EnableGroupListChangeEvents()

IMPORT_C TInt RWindowTreeNode::EnableGroupListChangeEvents ( )

Enables reporting of window group list change events.

The window group list is a list of all window groups and their z-order. Calling this function will cause notification events (of type EEventWindowGroupListChanged) for any change in the window group list: additions, removals and reorderings.

This function is useful when you need to know about changes to window groups beneath the focused one, for instance when the screen is showing windows from more than one window group at the same time.

The handle of the event is set to the client handle of the window that this function is called on.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ EnableModifierChangedEvents()

IMPORT_C TInt RWindowTreeNode::EnableModifierChangedEvents	(	TUint	aModifierMask,
		TEventControl	aCircumstances
	)

Requests notification of modifier changed events.

Use this function to instruct the window server to report modifier changed events to this window. Values for the modifier keys are defined in TEventModifier. If more than one modifier key is to be monitored, their values should be combined using a bit-wise OR operation. Modifier changed events are of type EEventModifiersChanged.

This function always causes a flush of the window server buffer.

DisableModifierChangedEvents()

Parameters

aModifierMask	The modifiers to be reported. May be a combination of values defined in TEventModifier
aCircumstances	The circumstances in which modifier changed events are to be reported.

(generated from Symbian Developer Library)

◆ EnableOnEvents()

IMPORT_C TInt RWindowTreeNode::EnableOnEvents ( TEventControl aCircumstances = EEventControlOnlyWithKeyboardFocus )

Requests notification of 'on' events.

'On' events are of type EEventSwitchOn.

This function always causes a flush of the window server buffer.

DisableOnEvents()

Parameters

aCircumstances The circumstances in which 'on' events are to be reported.

(generated from Symbian Developer Library)

◆ EnableVisibilityChangeEvents()

IMPORT_C TInt RWindowTreeNode::EnableVisibilityChangeEvents ( )

Enables reporting of window visibility change events.

The window visibility is based on whether or not any area of the window can be seen on the screen. This can be affected by SetVisible(), but also by other windows in front of this one, and by the presence of transparent windows which it can be seen through. Calling this function will cause notification events (of type EEventWindowVisibilityChanged) for any change in the window's visibility.

This function is useful when you are performing graphical processing such as animations and would like to stop them while they cannot be seen, for efficiency reasons.

The handle of the event is set to the client handle of the window that this function is called on.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ FullOrdinalPosition()

IMPORT_C TInt RWindowTreeNode::FullOrdinalPosition ( ) const

Get the current full ordinal position of a window.

This function normally returns a useful value only when called on a window group, because only window groups are normally given different priorities. For other types of window the value returned is usually the same as that returned by OrdinalPosition().

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ NextSibling()

IMPORT_C TUint32 RWindowTreeNode::NextSibling ( ) const

Gets the next window after this one in its sibling list.

The return value is the client handle that was passed in the next sibling window's Construct() function: see RWindow::Construct() for a description of the client handle.

This function always causes a flush of the window server buffer.

PrevSibling() Child() Parent()

(generated from Symbian Developer Library)

◆ OrdinalPosition()

IMPORT_C TInt RWindowTreeNode::OrdinalPosition ( ) const

Gets the current ordinal position of the window tree node.

The ordinal position returned is the window's position amongst windows with the same parent (an with the same priority). Displayable windows almost always have the same priority, but window groups might typically have different priorities. If a window group's ordinal position among window groups of all priorities is required, use FullOrdinalPosition().

Note: all group windows (across all clients) have the same parent.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ OrdinalPriority()

IMPORT_C TInt RWindowTreeNode::OrdinalPriority ( ) const

Gets the ordinal priority of the specified window.

This function was added for FEPs that need to know the priority in their dialogues.

This function and RWsSession::GetWindowGroupOrdinalPriority() may return different values because this function isn't subject to any ordinal priority adjustment, while the window group ordinal priority may be.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ Parent()

IMPORT_C TUint32 RWindowTreeNode::Parent ( ) const

Gets the node's parent.

The return value is the client's integer handle that was passed as an argument to the parent window tree node's Construct() function: see RWindow::Construct() for a description of the client handle. If called on a window group, this function returns 0, as window groups have no parent.

This function always causes a flush of the window server buffer.

Child() RWindow::Construct()

(generated from Symbian Developer Library)

◆ PrevSibling()

IMPORT_C TUint32 RWindowTreeNode::PrevSibling ( ) const

Gets the node before this one in the sibling list.

The return value is the client handle that was passed in the previous sibling window's Construct() function: see RWindow::Construct() for a description of the client handle.

This function always causes a flush of the window server buffer.

NextSibling() RWindow::Construct()

(generated from Symbian Developer Library)

◆ ScreenNumber()

IMPORT_C TInt RWindowTreeNode::ScreenNumber ( ) const

Get the screen number that a window is located on.

(generated from Symbian Developer Library)

◆ Session()

IMPORT_C RWsSession * RWindowTreeNode::Session ( ) const

Returns the window server session that is used to create this window handle.

This functions returns null if the window handle is not initialised.

RWindowTreeNode(RWsSession &aWs)

(generated from Symbian Developer Library)

◆ SetCustomPointerCursor()

IMPORT_C void RWindowTreeNode::SetCustomPointerCursor ( const RWsPointerCursor & aPointerCursor )

Sets the pointer cursor to an application-defined cursor.

Parameters

aPointerCursor The cursor to use.

(generated from Symbian Developer Library)

◆ SetFaded() [1/2]

IMPORT_C void RWindowTreeNode::SetFaded	(	TBool	aFaded,
		TFadeControl	aIncludeChildren
	)

Sets the window as faded or unfaded.

This function allows a single window to be faded or unfaded. The function also allows the same action to be applied to all of the window's children.

Notes:

A redraw is required to un-fade a window because information is lost during fading (blank and backup windows deal with this themselves). Areas in shadow when the window is faded also require a redraw.

While a window is faded, all drawing to that window will be adjusted appropriately by the window server.

Parameters

aFaded	ETrue to fade the window, EFalse to un-fade it.
aIncludeChildren	Fade control flags. These set whether fading/un-fading also apply to child windows.

(generated from Symbian Developer Library)

◆ SetFaded() [2/2]

IMPORT_C void RWindowTreeNode::SetFaded	(	TBool	aFaded,
		TFadeControl	aIncludeChildren,
		TUint8	aBlackMap,
		TUint8	aWhiteMap
	)

Sets one or more windows as faded or unfaded, specifying a fading map.

Fading is used to change the colour of a window to make other windows stand out. For example, you would fade all other windows when displaying a dialogue.

Fading makes a window closer to white or closer to black. Setting the fading map allows you to over-ride the default fading parameters set in RWsSession::SetDefaultFadingParameters().

The white and black fading values define the range over which colours are re-mapped when a window is faded. As the values get closer together, all colours in the faded window becomes more similar, creating the fading effect. When the numbers cross over (so that the black value is greater than the white value) the colours in the faded window start to invert, i.e. colours that were closer to white in the unfaded window are mapped to a darker colour when the window is faded.

The function also allows the fading action applied to this window to be applied to all of its children.

Notes:

Fading a window for a 2nd time will not change the fading map used.

A redraw is required to un-fade a window because information is lost during fading. Note that blank (RBlankWindow) and backup (RBackedUpWindow) windows deal with this themselves. Areas in shadow when the window is faded also require a redraw.

While a window is faded all drawing to that window will be adjusted appropriately by the window server.

RWsSession::SetDefaultFadingParameters() CWindowGc::SetFadingParameters()

Parameters

aFaded	ETrue to fade the window, EFalse to un-fade it.
aIncludeChildren	Fade control flags. This sets whether fading/un-fading is also to apply to all child windows.
aBlackMap	Black map fading parameter.
aWhiteMap	White map fading parameter.

(generated from Symbian Developer Library)

◆ SetNonFading()

IMPORT_C void RWindowTreeNode::SetNonFading ( TBool aNonFading )

Sets whether a window is non-fading.

When the non-fading flag is set the window will unfade if needed and remain unfaded until this flag is removed. This is useful for toolbars etc. which must never be faded.

Parameters

aNonFading ETrue to set the non-fading flag, EFalse (the default) to re-set it.

(generated from Symbian Developer Library)

◆ SetOrdinalPosition() [1/2]

IMPORT_C void RWindowTreeNode::SetOrdinalPosition ( TInt aPos )

Sets the ordinal position of a window.

A window's ordinal position is relative to its siblings with the same ordinal priority. The ordinal priority of displayable windows (in other words, not window groups) is almost always zero (the default). To set the ordinal priority as well as the ordinal position, use the other overload of this function.

The lower the ordinal position, the nearer the window will be to the front of the z-order. The frontmost window has ordinal position zero. Specifying a negative value has the effect of sending the window to the back of the z-order.

Note: If this window is a window group in a chain, then all other window groups in the chain will be moved also. When this function is called on Group Window with aPos set to KOrdinalPositionSwitchToOwningWindow then the function doesn't change the ordinal position of the group window, if instead it has focus then the window group that would come to the forground if it died will be moved to the foreground.

Parameters

aPos	The window's new ordinal position. The lower the ordinal, the closer to the front of the z-order the window will be. Specifying any negative value however, sends the window to the back of the z-order.

(generated from Symbian Developer Library)

◆ SetOrdinalPosition() [2/2]

IMPORT_C void RWindowTreeNode::SetOrdinalPosition	(	TInt	aPos,
		TInt	aOrdinalPriority
	)

Sets the ordinal position and ordinal priority of a window.

Ordinal priority is a number assigned to a window that determines its position in the z-order. For sibling windows or group windows, the higher the priority, the closer it will be to the front. Ordinal priority overrides ordinal position, so that the ordinal position is only taken into account for sibling windows or window groups with the same ordinal priority. For a description of ordinal position, see the other overload of this function.

Most windows have an ordinal priority of zero. Only window groups are normally given non-default ordinal priorities.

To set priority of KPasswordWindowGroupPriority or greater on a window group, client will require SwEvent capability. If client does not have SwEvent capability then priority will be reduced to KPasswordWindowGroupPriority-1. This function doesn't return an error thus the client cannot tell if the priority is reduced, however, there is another function that can be used if the client does require an error, this is RWindowGroup::SetOrdinalPositionErr.

Note: If this window is a window group in a chain, then all other window groups in the chain will be moved also. And further they will all have their ordinal priority set to the specified value. When this function is called on Group Window with aPos set to KOrdinalPositionSwitchToOwningWindow then the function doesn't change the ordinal position of the group window, if instead it has focus then the window group that would come to the forground if it died will be moved to the foreground.

Parameters

aPos	The window's new ordinal position. The lower the ordinal, the closer to the front of the z-order the window will be. Specifying any negative value however, sends the window to the back of the z-order.
aOrdinalPriority	The window's new ordinal priority.

(generated from Symbian Developer Library)

◆ SetPointerCursor()

IMPORT_C TInt RWindowTreeNode::SetPointerCursor ( TInt aCursorNumber )

Sets the pointer cursor from the system pointer cursor list.

Use this function to set the current cursor to one contained in the system pointer cursor list. If the list does not contain a cursor with an index of aCursorNumber, the function will attempt to set the cursor to the default system pointer cursor, which has an index of 0 in the list.

The RWsSession class provides functions for setting and controlling the system pointer cursor list.

This function always causes a flush of the window server buffer.

ClearPointerCursor()

Parameters

aCursorNumber The cursor index in the system pointer cursor list.

(generated from Symbian Developer Library)

◆ WindowGroupId()

IMPORT_C TInt RWindowTreeNode::WindowGroupId ( ) const

Returns the window group Id of the parent window group.

If the window is a window group it will return it's Id. If it is not it scans up the window tree to find the group window from which this window is descended and returns it's Id.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

Friends And Related Symbol Documentation

◆ CWindowGc

friend class CWindowGc

friend

Definition at line 1666 of file w32std.h.

◆ RAnimDll

friend class RAnimDll

friend

Definition at line 1667 of file w32std.h.

◆ RWindowBase

friend class RWindowBase

friend

Definition at line 1665 of file w32std.h.

◆ RWindowGroup

friend class RWindowGroup

friend

Definition at line 1664 of file w32std.h.

◆ RWsSprite

friend class RWsSprite

friend

Definition at line 1668 of file w32std.h.

Member Data Documentation

◆ __DECLARE_TEST

RWindowTreeNode::__DECLARE_TEST

protected

Definition at line 1724 of file w32std.h.

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ TFadeControl

Constructor & Destructor Documentation

◆ RWindowTreeNode() [1/2]

◆ RWindowTreeNode() [2/2]

Member Function Documentation

◆ Child()

◆ ClearPointerCursor()

◆ ClientHandle()

◆ Close()

◆ Destroy()

◆ DisableErrorMessages()

◆ DisableFocusChangeEvents()

◆ DisableGroupChangeEvents()

◆ DisableGroupListChangeEvents()

◆ DisableModifierChangedEvents()

◆ DisableOnEvents()

◆ DisableVisibilityChangeEvents()

◆ EnableErrorMessages()

◆ EnableFocusChangeEvents()

◆ EnableGroupChangeEvents()

◆ EnableGroupListChangeEvents()

◆ EnableModifierChangedEvents()

◆ EnableOnEvents()

◆ EnableVisibilityChangeEvents()

◆ FullOrdinalPosition()

◆ NextSibling()

◆ OrdinalPosition()

◆ OrdinalPriority()

◆ Parent()

◆ PrevSibling()

◆ ScreenNumber()

◆ Session()

◆ SetCustomPointerCursor()

◆ SetFaded() [1/2]

◆ SetFaded() [2/2]

◆ SetNonFading()

◆ SetOrdinalPosition() [1/2]

◆ SetOrdinalPosition() [2/2]

◆ SetPointerCursor()

◆ WindowGroupId()

Friends And Related Symbol Documentation

◆ CWindowGc

◆ RAnimDll

◆ RWindowBase

◆ RWindowGroup

◆ RWsSprite

Member Data Documentation

◆ __DECLARE_TEST