CSatelliteInfoUI Class Reference

class CSatelliteInfoUI : public CBase

Implements entry point class to Satellite Info UI

Inherits from

Constructor & Destructor Documentation

CSatelliteInfoUI()

CSatelliteInfoUI ( ) [private]

C++ default constructor.

~CSatelliteInfoUI()

IMPORT_C ~CSatelliteInfoUI ( ) [virtual]

Destructor.

Member Functions Documentation

ConstructL()

void ConstructL ( ) [private]

By default Symbian 2nd phase constructor is private.

ExecuteLD(const TDesC &)

IMPORT_C TInt ExecuteLD ( const TDesC & aNameOfRule )

Display satellite's information dialog.

This library uses the services provided by Location Framework. Once the dialog is launched satellite information is continuously requested via Location Acquisition API. The Location Acquisition API is offered by Location Framework. The user can switch between the two views once the dialog is launched.

leave
KErrArgument if requestor data (aNameOfRule argument) length exceeds 255 characters or if it is empty. This function may also leave with any one of the standard error codes such as out of memory (e.g. KErrNoMemory)

Parameters

const TDesC & aNameOfRule is requestor data for Location FW which will be used for privacy verification in the future. Application name should be used to specify the requestor. The string should not be empty.

HandleForegroundEventL(TBool)

IMPORT_C void HandleForegroundEventL ( TBool aForeground )

Dialog switched to foreground or background

Parameters

TBool aForeground ETrue to switch to the foreground. EFalse to switch to background.

NewL()

IMPORT_C CSatelliteInfoUI * NewL ( ) [static]

Two-phased constructor.

SetLaunchView(TSatelliteView)

IMPORT_C void SetLaunchView ( TSatelliteView aLaunchView )

Used to set the dialog's launch view

This method is used to set the view in which the dialog should be launched. The two available views are signal strength and firmament view. Constants for settings default view specified in enum TSatelliteView . This method should be called before the method ExecuteLD is invoked.

panic
EAknPanicOutOfRange if the method is invoked with an invalid parameter. Values provided apart from those specified in TSatelliteView are invalid and will cause the method to panic.

Parameters

TSatelliteView aLaunchView ESatelliteFirmamentView for firmament view and ESatelliteSignalStrengthView for signal strength view. ESatelliteCompassView for compass ciew ESatelliteCompassView Visibility will be variated depending on the product configuration/regional variation. if it is disabled to show compass view then function will ignore the ESatelliteCompassView and show firmament view instead.

Member Enumerations Documentation

Enum TSatelliteView

Enumeration to specify the default launch view of the dialog.

Enumerators

ESatelliteFirmamentView = 0x0001

Launch option for firmament view. Firmament view displays all the satellites in view with the satellite's number on a firmament.

ESatelliteSignalStrengthView = 0x0002

Launch option for signal strength view. Signal strength view displays all the satellite with their correspoinding signal strength represented by bars.

ESatelliteCompassView = 0x0003

Launch option for compass view. Compass view displays latitude, longitude, speed and direction along with 2D/3D type of Fix.

Member Data Documentation

TBool * iDestroyedPtr

TBool * iDestroyedPtr [private]

CSatellite * iSatellite

CSatellite * iSatellite [private]

Own: A pointer to CSatellite. Contains the engine and the dialog implementation.