TPositionModuleStatusEventBase Class Reference

#include <lbscommon.h>

Link against: lbs.lib

class TPositionModuleStatusEventBase : public TPositionClassTypeBase

Inherits from

Detailed Description

The base class for classes storing position module status events

Member Type Definition Documentation

Typedef TModuleEvent

typedef TUint32 TModuleEvent

defined type for TModuleEvent

Typedef TSystemModuleEvent

typedef TUint32 TSystemModuleEvent

defined type for TSystemModuleEvent

Member Attribute Documentation

iModuleId

TPositionModuleId iModuleId[protected]

The module ID causing the event

iOccurredEvents

TModuleEvent iOccurredEvents[protected]

A bitmask of the events which occurred

iRequestedEvents

TModuleEvent iRequestedEvents[protected]

A bitmask of the requested events

iSystemModuleEvent

TSystemModuleEvent iSystemModuleEvent[protected]

System level module status events

Member Enumeration Documentation

Enum _TModuleEvent

Module events

EnumeratorValueDescription
EEventNone0

No module event This is the unassigned value and should not be reported or used

EEventDeviceStatus0x01

Module event device status Events about the general status of the device. When this type of event occurs, client applications should inspect the value returned by the TPositionModuleInfo::DeviceStatus() method for more information

EEventDataQualityStatus0x02

Module Data Quality status Events about the quality of the data a module is able to return. When this type of event occurs, client applications should inspect the value returned by the TPositionModuleInfo::DataQualityStatus() method for more information.

EEventSystemModuleEvent0x04

Module System Event System level events about the status of modules. Events of this type indicate when modules have been added or removed from the system. When this event type occurs, client applications should inspect the value returned by TPositionModuleInfo::SystemModuleEvent() to determine which particular event was responsible

EEventAllEEventDeviceStatus | EEventDataQualityStatus | EEventSystemModuleEvent

All events

Enum _TSystemModuleEvent

Module events

EnumeratorValueDescription
ESystemUnknown0

System Unknown This is not a valid state and should never be reported

ESystemError

System Error There are problems using the module. For example, the module may have terminated abnormally. It should not be confused with the module reporting the error EDeviceError via TPositionModuleStatus::DeviceStatus(). That signifies the module itself is up and running - but it may be unable to successful communicate with the hardware

ESystemModuleInstalled

System Module Installed A new positioning module has been dynamically added to the system. To receive this event, the client application must have expressed interest in status notifications from any positioning module. The Id of the newly installed module can be found by calling TPositionModuleStatusEvent::ModuleId().

ESystemModuleRemoved

System Module Removed A positioning module is uninstalled. The Id of the removed module can be found by calling TPositionModuleStatusEvent::ModuleId()

Constructor & Destructor Documentation

TPositionModuleStatusEventBase ( )

IMPORT_CTPositionModuleStatusEventBase()[protected]

Default constructor for TPositionModuleStatusEventBase

TPositionModuleStatusEventBase ( TModuleEvent )

IMPORT_CTPositionModuleStatusEventBase(TModuleEventaRequestedEventMask)[protected]

Constructor for TPositionModuleStatusEventBase (with events)

ParameterDescription
aRequestedEventMaskThe requested events

Member Function Documentation

DoReset ( TInt )

IMPORT_C voidDoReset(TIntaSizeOfClass)[protected, virtual]

Method to reset a TPositionModuleStatusEventBase to the 'unknown' state.

ParameterDescription
aSizeOfClassFunction asserts that aSizeOfClass == sizeof(TPositionModuleStatusEventBase) to ensure DoReset was overridden in derived class.

ModuleId ( )

IMPORT_C TPositionModuleIdModuleId()const

Returns the module ID

Returns: The module ID

OccurredEvents ( )

IMPORT_C TModuleEventOccurredEvents()const

Returns the events which have occurred

Returns: The events which have occurred

RequestedEvents ( )

IMPORT_C TModuleEventRequestedEvents()const

Returns the requested events

Returns: The requested events

SetModuleId ( TPositionModuleId )

IMPORT_C voidSetModuleId(TPositionModuleIdaModuleId)

The module ID to set

ParameterDescription
aModuleIdThe module ID to set

SetOccurredEvents ( TModuleEvent )

IMPORT_C voidSetOccurredEvents(TModuleEventaOccurredEventMask)

The occurred events to set

ParameterDescription
aOccurredEventMaskThe occurred events to set

SetRequestedEvents ( TModuleEvent )

IMPORT_C voidSetRequestedEvents(TModuleEventaRequestedEventMask)

Sets the requested events

ParameterDescription
aRequestedEventMaskThe requested events to set

SetSystemModuleEvent ( TSystemModuleEvent )

IMPORT_C voidSetSystemModuleEvent(TSystemModuleEventaSystemModuleEvent)

Sets the system event

ParameterDescription
aSystemModuleEventThe system event to set.

SystemModuleEvent ( )

IMPORT_C TSystemModuleEventSystemModuleEvent()const

Returns The system event type.

Returns: The system event type.