Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <LbsCommon.h>
Link against: lbs.lib
Link against: lbsselflocate.lib

Class TPositionModuleInfo

class TPositionModuleInfo : public TPositionModuleInfoBase;

Description

The standard class for storing information on position modules

Derivation

Members

Defined in TPositionModuleInfo:

Inherited from TPositionClassTypeBase:


Construction and destruction


TPositionModuleInfo()

IMPORT_C TPositionModuleInfo();

Description

Default constructor for TPositionModuleInfo

[Top]


Member functions


ModuleId()const

IMPORT_C TPositionModuleId ModuleId() const;

Description

Module Id

Return value

TUid

The module ID


IsAvailable()const

IMPORT_C TBool IsAvailable() const;

Description

Returns Availablity

Return value

TBool

Whether or not this module is available


GetModuleName(TDes &)const

IMPORT_C void GetModuleName(TDes &aModuleName) const;

Description

Gets Module Name

Parameters

TDes16 &aModuleName

The descriptor where the module's name will be placed


GetPositionQuality(TPositionQuality &)const

IMPORT_C void GetPositionQuality(TPositionQuality &aPosQuality) const;

Description

Gets Position Quality

Parameters

TPositionQuality &aPosQuality

The quality of the position


TechnologyType()const

IMPORT_C TTechnologyType TechnologyType() const;

Description

Technology Type

Return value

TPositionModuleInfo::TTechnologyType

The technology type


DeviceLocation()const

IMPORT_C TDeviceLocation DeviceLocation() const;

Description

Device Location

Return value

TPositionModuleInfo::TDeviceLocation

The location of the positioning device associated with this module


Capabilities()const

IMPORT_C TCapabilities Capabilities() const;

Description

Capabilities

Return value

TPositionModuleInfo::TCapabilities

The capabilities of this module


ClassesSupported(TPositionClassFamily)const

IMPORT_C TUint32 ClassesSupported(TPositionClassFamily aClassType) const;

Description

Classes Supported

Parameters

TPositionClassFamily aClassType

Classes Supported

Return value

TUint32

The classes supported


Version()const

IMPORT_C TVersion Version() const;

Description

Module Version

Return value

TVersion

The version of the module


SetModuleId(TPositionModuleId)

IMPORT_C void SetModuleId(TPositionModuleId aModuleId);

Description

Sets module Id

Parameters

TUid aModuleId

The module ID to set


SetIsAvailable(TBool)

IMPORT_C void SetIsAvailable(TBool aIsAvailable);

Description

Sets module availablity

Parameters

TBool aIsAvailable

Whether or not the module is available for use


SetModuleName(const TDesC &)

IMPORT_C void SetModuleName(const TDesC &aModuleName);

Description

Sets module name

Parameters

const TDesC16 &aModuleName

The module name to set


SetPositionQuality(const TPositionQuality &)

IMPORT_C void SetPositionQuality(const TPositionQuality &aPosQuality);

Description

Sets position quality

Parameters

const TPositionQuality &aPosQuality

The position quality to set


SetTechnologyType(TTechnologyType)

IMPORT_C void SetTechnologyType(TTechnologyType aTechnologyType);

Description

Sets technology type

Parameters

TPositionModuleInfo::TTechnologyType aTechnologyType

The technology type to set


SetDeviceLocation(TDeviceLocation)

IMPORT_C void SetDeviceLocation(TDeviceLocation aDeviceLocation);

Description

Sets device location

Parameters

TPositionModuleInfo::TDeviceLocation aDeviceLocation

The positioning device location to set


SetCapabilities(TCapabilities)

IMPORT_C void SetCapabilities(TCapabilities aDeviceCapabilities);

Description

Sets capabilities

Parameters

TPositionModuleInfo::TCapabilities aDeviceCapabilities

Bitfield of the capabilities of this module to set


SetClassesSupported(TPositionClassFamily,TUint32)

IMPORT_C void SetClassesSupported(TPositionClassFamily aClassType, TUint32 aSupportedClasses);

Description

Sets supported classes

Parameters

TPositionClassFamily aClassType

The class type

TUint32 aSupportedClasses

The supported classes


SetVersion(TVersion)

IMPORT_C void SetVersion(TVersion aVersion);

Description

Sets Version

Parameters

TVersion aVersion

The version to set

[Top]


Member enumerations


Enum _TTechnologyType

_TTechnologyType

Description

Technology Type

ETechnologyUnknown

Indicates that the positioning module is unaware of the technology used to obtain position information

ETechnologyTerminal

The primary positioning technology is handset based. For example standard GPS

ETechnologyNetwork

The primary positioning technology is network based. For example, E-OTD

ETechnologyAssisted

The primary positioning mechanism receives assistance in some form. Generally to obtain a quicker or more accurate fix


Enum _TDeviceLocation

_TDeviceLocation

Description

Device location

EDeviceUnknown

The positioning module is unaware of the hardware used to supply positioning information

EDeviceInternal

The positioning hardware is integral to the terminal

EDeviceExternal

The positioning hardware is separate from the terminal


Enum _TCapabilities

_TCapabilities

Description

Module Capabilities

ECapabilityNone

No Capabilities

ECapabilityHorizontal

Positioning modules with this capability will support the TPositionInfo class and are able to provide latitude and longitude related information

ECapabilityVertical

Positioning modules with this capability will support the TPositionInfo class and are able to provide height related information

ECapabilitySpeed

Positioning modules with this capability will support the TPositionCourseInfo class and are able to provide information related to the current horizontal speed

ECapabilityDirection

Positioning modules with this capability will support the TPositionCourseInfo class and are able to provide heading related information

ECapabilitySatellite

Positioning modules with this capability will support the TPositionSatelliteInfo class. Such a module will be able to return at least some satellite data - but the extent of the information could vary. Applications must ensure that any value returned is valid before it is used

ECapabilityCompass

This value is reserved for future expansion. Positioning modules with this capability will be able to return information related to a magnetic compass. The API does not currently define an extended class that encapsulates this type of information

ECapabilityNmea

This value is reserved for future expansion. Positioning modules with this capability will be able to return location information using NMEA formatted text strings. The API does not currently define an extended class that encapsulates this type of information

ECapabilityAddress

This value is reserved for future expansion. Positioning modules with this capability will be able to return information related to the postal address of the current location

ECapabilityBuilding

This value is reserved for future expansion. Positioning modules with this capability will be able to return the current position in terms of where within a building it is. For example, this may include the floor and the room name. The API does not currently define an extended class that encapsulates this type of information

ECapabilityMedia

This value is reserved for future expansion. Positioning modules with this capability will be able to return provide a link to further information about the location. The standard mechanism is via a URL. The API does not currently define an extended class that encapsulates this type of information

[Top]


Member type definitions


Typedef TTechnologyType

typedef TUint32 TPositionModuleInfo::TTechnologyType;

Description

Technology types


Typedef TDeviceLocation

typedef TUint32 TPositionModuleInfo::TDeviceLocation;

Description

Device locations


Typedef TCapabilities

typedef TUint32 TPositionModuleInfo::TCapabilities;

Description

Position module capabilities

[Top]


Member data


iModuleId

protected: TPositionModuleId iModuleId;

Description

The module ID


iIsAvailable

protected: TBool iIsAvailable;

Description

Whether or not the module is available


iModuleName

protected: TBuf< KPositionMaxModuleName > iModuleName;

Description

The module name


iPosQuality

protected: TPositionQuality iPosQuality;

Description

The position quality


iTechnologyType

protected: TTechnologyType iTechnologyType;

Description

The technology type


iDeviceLocation

protected: TDeviceLocation iDeviceLocation;

Description

The location of the device associated with this module


iCapabilities

protected: TCapabilities iCapabilities;

Description

The capabilities of this module


iSupportedClassTypes

protected: TFixedArray< TUint32, EPositionLastFamily > iSupportedClassTypes;

Description

The array of supported classes for the different class types


iVersion

protected: TVersion iVersion;

Description

The version of this module