Collapse all Symbian^3 Application Developer Library

MHierarchyObserver Class Reference

class MHierarchyObserver

An interface to the domain manager for an observer.

To make use of this class, an application must derive from it and implement the pure vitual functions to handle transition event notifications.

Public Member Functions
void	TransFailEvent ( TDmDomainId , TDmDomainState , TInt )
void	TransProgEvent ( TDmDomainId , TDmDomainState )
void	TransReqEvent ( TDmDomainId , TDmDomainState )

Member Functions Documentation

TransFailEvent(TDmDomainId, TDmDomainState, TInt)

void	TransFailEvent	(	TDmDomainId	aDomainId,
			TDmDomainState	aState,
			TInt	aError
		)	[pure virtual]

When observer is active, then upon any failing transition, this will be called indicating the Id of the domain, the state of the domain for the transition and the error occured. Clients are expected to use this for debugging purpose.

Parameters

TDmDomainId aDomainId
TDmDomainState aState
TInt aError

TransProgEvent(TDmDomainId, TDmDomainState)

void	TransProgEvent	(	TDmDomainId	aDomainId,
			TDmDomainState	aState
		)	[pure virtual]

When the observer is active, then upon any successful transition, this will be called indicating the Id of the transitioned domain and the state of the domain after the transition. Clients are expected to use this for debugging purpose.

Parameters

TDmDomainId aDomainId
TDmDomainState aState

TransReqEvent(TDmDomainId, TDmDomainState)

void	TransReqEvent	(	TDmDomainId	aDomainId,
			TDmDomainState	aState
		)	[pure virtual]

When observer is active, then upon any request for transition, this will be called indicating the Id of the domain and the desired state of the domain. Clients are expected to use this for debugging purpose.

Parameters

TDmDomainId aDomainId
TDmDomainState aState