Collapse all Symbian^3 Application Developer Library

MPbk2StartupMonitor Class Reference

class MPbk2StartupMonitor

Phonebook 2 start-up monitor interface. Offers a possibility to get a start-up complete event.

Public Member Functions
void	DeregisterEvents ( MPbk2StartupObserver &)
void	HandleStartupComplete ()
void	HandleStartupFailed ( TInt )
void	NotifyViewActivationL ( TUid )
void	NotifyViewActivationL ( TUid , MVPbkContactViewBase &)
void	RegisterEventsL ( MPbk2StartupObserver &)
TAny *	StartupMonitorExtension ( TUid )

Protected Member Functions
	~MPbk2StartupMonitor ()

Constructor & Destructor Documentation

~MPbk2StartupMonitor()

~MPbk2StartupMonitor

(

)

[protected, inline, virtual]

Member Functions Documentation

DeregisterEvents(MPbk2StartupObserver &)

void

DeregisterEvents

(

MPbk2StartupObserver &

aObserver

)

[pure virtual]

Removes an observer from the monitor. Does nothing the if observer does not exist.

Parameters

MPbk2StartupObserver & aObserver

An observer to be removed.

HandleStartupComplete()

void

HandleStartupComplete

(

)

[pure virtual]

Extensions that are loaded in start-up must call this after their own start-up routines have been done.

HandleStartupFailed(TInt)

void

HandleStartupFailed

(

TInt

aError

)

[pure virtual]

Called if there is an error during the start-up.

Parameters

TInt aError

Error code.

NotifyViewActivationL(TUid)

void

NotifyViewActivationL

(

TUid

aViewId

)

[pure virtual]

Notify the startup monitor of an application view launch. The monitor will be activated only for the first application view but the client doesn't need to worry about that.

Must be called from the application view's DoActivateL if the view can be directly launched from other process (e.g. using CPbkViewState or CPbk2ViewState ).

Uses AllContactsViewL for waiting. If you have some other view then use the specialised version.

Parameters

TUid aViewId

Id of the launched view.

NotifyViewActivationL(TUid, MVPbkContactViewBase &)

void	NotifyViewActivationL	(	TUid	aViewId,
			MVPbkContactViewBase &	aContactView
		)	[pure virtual]

Notify the startup monitor of an application view launch. The monitor will be activated only for the first application view but the client doesn't need to worry about that.

Must be called from the application view's DoActivateL if the view can be directly launched from other process (e.g. using CPbkViewState or CPbk2ViewState ).

Uses given contact view for waiting.

Parameters

TUid aViewId	Id of the launched view.
MVPbkContactViewBase & aContactView	The view that will be waited by the monitor. The monitor saves the reference of aContactView until it gets it's job done. The application view must call NotifyViewDeActivation in DoDeactivate to reset the aContactView reference.