Revision as of 09:05, 13 June 2012

Archived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

Note: :This API is not part of the public SDK. It can be found in the SDK API Plug-in.

Purpose

The Location Settings Launch API is used for launching the Location Notation Prefences Settings UI and the Position Method Settings UI.

Header files

 locsettingsuiclient.h

Link against

 locsettingsuiclient.lib

Code examples

The client-side resource class to launch the Location settings UI is done using the CLocSettingsUiClient class. The following code is used to initialize the class.

 CLocSettingsUiClient* iLocSettingsUi = CLocSettingsUiClient::NewL();

Launching the Position Method Settings UI:

 // UID for launching Position Method Settings 
 // const TInt KLocPsySettingsUID  = 0x10275062;
 TRAPD(err, iLocSettingsUi->LaunchSettingsUiAsEmbeddedAppL(TUid::Uid
 (KLocPsySettingsUID),KDefaultParamValue,iStatus));

Launching the Location Notation Preferences Setting UI:

 // UID for launching Location Notation Prefences Settings UI is 
 // const TInt KLocNotPrefSettingsUID = 0x1020690F;
 TRAPD(err, iLocSettingsUi->LaunchSettingsUiAsEmbeddedAppL( 
 TUid::Uid(KLocNotPrefSettingsUID), KDefaultParamValue, iStatus ));

Canceling an already launched settings UI:

 iLocSettingsUi->CancelLaunchedSettingsUi();

Releasing code:

 delete iLocSettingsUi;

Example project

File:LocalSettingUi.zip