Collapse all Symbian^3 Application Developer Library

CMnNavigator Class Reference

class CMnNavigator : public CBase

To create an instance of the class, use NewL or NewChainedL methods. They require instance of CMnProvider , defined in Map and Navigation Provider Discovery API.

Since: 3.1 mnclientlib.dll

Inherits from

CMnNavigator
- CBase

Public Member Functions
	~CMnNavigator ()
IMPORT_C void	NavigateToL (const CPosLandmark &)
IMPORT_C CMnNavigator *	NewChainedL ( CMnProvider &)
IMPORT_C CMnNavigator *	NewL ( CMnProvider &)
IMPORT_C void	RemoveExitObserver ()
IMPORT_C void	SetExitObserverL ( MAknServerAppExitObserver &)

Private Member Functions
	CMnNavigator ()
void	ConstructChainedL ( CMnProvider &)
void	ConstructCommonL ( CMnProvider &)
void	ConstructNewL ( CMnProvider &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Attributes
CApaServerAppExitMonitor *	iExitMonitor
RMnNavigationServiceClient *	iSession

Constructor & Destructor Documentation

CMnNavigator()

CMnNavigator

(

)

[private]

C++ constructor

~CMnNavigator()

IMPORT_C

~CMnNavigator

(

)

Destructor

Member Functions Documentation

ConstructChainedL(CMnProvider &)

void

ConstructChainedL

(

CMnProvider &

aProvider

)

[private]

Parameters

CMnProvider & aProvider

ConstructCommonL(CMnProvider &)

void

ConstructCommonL

(

CMnProvider &

aProvider

)

[private]

Parameters

CMnProvider & aProvider

ConstructNewL(CMnProvider &)

void

ConstructNewL

(

CMnProvider &

aProvider

)

[private]

Parameters

CMnProvider & aProvider

NavigateToL(const CPosLandmark &)

IMPORT_C void

NavigateToL

(

const CPosLandmark &

aDestination

)

This method completes as soon as navigation request reaches Provider Application. Navigation is held then in Provider Application's process.

Navigation destination is specified as landmark. This landmark does not have to contain coordinate information, in which case its address information will be used, if present. If neither coordinate nor address information is present in the landmark, then this method leaves with KErrArgument.

This is synchronous request. It is completed as soon as navigation starts on Provider Application side.

leave: KErrArgument if neither coordinate nor address information is present in the landmark

Parameters

const CPosLandmark & aDestination

Navigation destination.

NewChainedL(CMnProvider &)

IMPORT_C CMnNavigator *

NewChainedL

(

CMnProvider &

aProvider

)

[static]

leave: KErrNotSupported Selected Provider Application does not support navigation services ( CMnProvider::EServiceNavigation ).

Parameters

CMnProvider & aProvider

Provider Application to be used for navigation.

NewL(CMnProvider &)

IMPORT_C CMnNavigator *

NewL

(

CMnProvider &

aProvider

)

[static]

leave: KErrNotSupported Selected Provider Application does not support navigation services ( CMnProvider::EServiceNavigation ).

Parameters

CMnProvider & aProvider

Provider Application to be used for navigation.

RemoveExitObserver()

IMPORT_C void

RemoveExitObserver

(

)

SetExitObserverL(MAknServerAppExitObserver &)

IMPORT_C void

SetExitObserverL

(

MAknServerAppExitObserver &

aObserver

)

leave: KErrAlreadyExists if observer is already set.

Parameters

MAknServerAppExitObserver & aObserver

Exit observer.

Member Data Documentation

CApaServerAppExitMonitor * iExitMonitor

CApaServerAppExitMonitor *

iExitMonitor

[private]

RMnNavigationServiceClient * iSession

RMnNavigationServiceClient *

iSession

[private]