TPositionModuleStatusEventBase Class Reference

API published in: S60 2nd Ed FP 2

Link against: lbs.lib

Capability Information

Required Capabilities

None

Exceptions

The capability Location is required in:

TInt RPositionServer::GetDefaultModuleId(TPositionModuleId& aModuleId) const;

TInt RPositionServer::GetNumModules(TUint& aNumModules) const;

TInt RPositionServer::GetModuleInfoByIndex(TInt aModuleIndex, TPositionModuleInfoBase& aModuleInfo) const;

TInt RPositionServer::GetModuleInfoById(TPositionModuleId aModuleId, TPositionModuleInfoBase& aModuleInfo) const;

TInt RPositionServer::GetModuleStatus(TPositionModuleStatusBase& aPosModuleStatus, TPositionModuleId aModuleId) const;

void RPositionServer::NotifyModuleStatusEvent(TPositionModuleStatusEventBase& aStatusEvent,TRequestStatus& aStatus,const TPositionModuleId aModuleId = KPositionNullModuleId) const;

TInt RPositioner::SetRequestor(CRequestor::TRequestorType aType,CRequestor::TRequestorFormat aFormat,const TDesC& aData);

TInt RPositioner::SetRequestor(const RRequestorStack& aRequestorStack);

TInt RPositioner::SetUpdateOptions(const TPositionUpdateOptionsBase& aPosOption);

TInt RPositioner::GetUpdateOptions(TPositionUpdateOptionsBase& aPosOption) const;

void RPositioner::GetLastKnownPosition(TPositionInfoBase& aPosInfo,TRequestStatus& aStatus) const;

void RPositioner::NotifyPositionUpdate(TPositionInfoBase& aPosInfo,TRequestStatus& aStatus) const;

#include <lbscommon.h>

Inherits TPositionClassTypeBase.

Inherited by TPositionModuleStatusEvent.

Detailed Description

The base class for classes storing position module status events.

Public Types

typedef TUint32 TSystemModuleEvent
 Defines the system wide events for a positioning module like installation/uninstalltion of a positioning module.
typedef TUint32 TModuleEvent
 Defines the type of event for by a positioning module.
enum  _TSystemModuleEvent { ESystemUnknown = 0, ESystemError, ESystemModuleInstalled, ESystemModuleRemoved }
 Module events. More...
enum  _TModuleEvent {
  EEventNone = 0, EEventDeviceStatus = 0x01, EEventDataQualityStatus = 0x02, EEventSystemModuleEvent = 0x04,
  EEventAll
}
 Module events. More...

Public Member Functions

IMPORT_C void SetRequestedEvents (TModuleEvent aRequestedEventMask)
 Set the events for which notification is requested.
IMPORT_C TModuleEvent RequestedEvents () const
 Get the events for which notification is requested.
IMPORT_C void SetOccurredEvents (TModuleEvent aOccurredEventMask)
 This method is not intended for the client's usage.
IMPORT_C TModuleEvent OccurredEvents () const
 Get the events which have Occurred.
IMPORT_C TPositionModuleId ModuleId () const
 Get the unique identifier for the positioning module.
IMPORT_C void SetModuleId (TPositionModuleId aModuleId)
 This method is not intended for the client's usage.
IMPORT_C void SetSystemModuleEvent (TSystemModuleEvent aSystemModuleEvent)
 This method is not intended for the client's usage.
IMPORT_C TSystemModuleEvent SystemModuleEvent () const
 Get the type of module system event that has occurred.

Protected Member Functions

IMPORT_C TPositionModuleStatusEventBase ()
 Default constructor for TPositionModuleStatusEventBase.
IMPORT_C TPositionModuleStatusEventBase (TModuleEvent aRequestedEventMask)
 Constructor.
virtual IMPORT_C void DoReset (TInt aSizeOfClass)

Protected Attributes

TModuleEvent iRequestedEvents
 A bitmask of the requested events.
TModuleEvent iOccurredEvents
 A bitmask of the events which occurred.
TSystemModuleEvent iSystemModuleEvent
 System level module status events.
TPositionModuleId iModuleId
 The module ID causing the event.

Friends

class RPositionServer

Member Typedef Documentation

typedef TUint32 TPositionModuleStatusEventBase::TModuleEvent
 

Defines the type of event for by a positioning module.

The events could be either system wide events or positioning related events. The values are defined by the enumerator _TModuleEvent.

typedef TUint32 TPositionModuleStatusEventBase::TSystemModuleEvent
 

Defines the system wide events for a positioning module like installation/uninstalltion of a positioning module.

The values are defined by the enumerator _TSystemModuleEvent.

Member Enumeration Documentation

enum TPositionModuleStatusEventBase::_TModuleEvent
 

Module events.

Enumerator:
EEventNone  This is an unassigned value and should not be reported or used.
EEventDeviceStatus  Events about the general status of the device.
EEventDataQualityStatus  Events about the quality of the data a positioning module is able to return.
EEventSystemModuleEvent  System level events about the status of modules.
EEventAll  indicates any one of the above mentioned events
enum TPositionModuleStatusEventBase::_TSystemModuleEvent
 

Module events.

Enumerator:
ESystemUnknown  This is not a valid state and should never be reported.
ESystemError  indicates that there are problems using the module.

For example, the module may have terminated abnormally

ESystemModuleInstalled  indicates that a new positioning module has been dynamically added to the system
ESystemModuleRemoved  indicates that a positioning module has been uninstalled

Constructor & Destructor Documentation

IMPORT_C TPositionModuleStatusEventBase::TPositionModuleStatusEventBase (   )  [protected]
 

Default constructor for TPositionModuleStatusEventBase.

IMPORT_C TPositionModuleStatusEventBase::TPositionModuleStatusEventBase ( TModuleEvent  aRequestedEventMask  )  [protected]
 

Constructor.

Parameters:
aRequestedEventMask a bit mask that indicates the type of status change events on which notification is requested
See also:
RPositionServer::NotifyModuleStatusEvent() to request for event notification

Member Function Documentation

virtual IMPORT_C void TPositionModuleStatusEventBase::DoReset ( TInt  aSizeOfClass  )  [protected, virtual]
 

Reimplemented in TPositionModuleStatusEvent.

IMPORT_C TPositionModuleId TPositionModuleStatusEventBase::ModuleId (   )  const
 

Get the unique identifier for the positioning module.

Returns:
The module ID
IMPORT_C TModuleEvent TPositionModuleStatusEventBase::OccurredEvents (   )  const
 

Get the events which have Occurred.

Returns:
The events which have occurred

EEventSystemModuleEvent In this case the client should use SystemModuleEvent() to determine the type of system event.

EEventDeviceStatus the client should call TPositionModuleStatusEvent::GetModuleStatus() to find the type of event.

EEventDataQualityStatus the client should call TPositionModuleStatusEvent::GetModuleStatus() to find the type of event.

IMPORT_C TModuleEvent TPositionModuleStatusEventBase::RequestedEvents (   )  const
 

Get the events for which notification is requested.

Returns:
The requested events
IMPORT_C void TPositionModuleStatusEventBase::SetModuleId ( TPositionModuleId  aModuleId  ) 
 

This method is not intended for the client's usage.

The Location framework uses this method to set the unique identifier for the positioning module for which this event has occured.

Parameters:
aModuleId The module ID to set
IMPORT_C void TPositionModuleStatusEventBase::SetOccurredEvents ( TModuleEvent  aOccurredEventMask  ) 
 

This method is not intended for the client's usage.

The Location framework uses this method to set the module event that has occured for this positioning module.

Parameters:
aOccurredEventMask The occurred events to set
IMPORT_C void TPositionModuleStatusEventBase::SetRequestedEvents ( TModuleEvent  aRequestedEventMask  ) 
 

Set the events for which notification is requested.

Parameters:
aRequestedEventMask The requested events to set
See also:
RPositionServer::NotifyModuleStatusEvent() to request for event notification
IMPORT_C void TPositionModuleStatusEventBase::SetSystemModuleEvent ( TSystemModuleEvent  aSystemModuleEvent  ) 
 

This method is not intended for the client's usage.

The Location framework uses this method to set the system event that has occured for this positioning module.

Parameters:
aSystemModuleEvent The system event to set.
IMPORT_C TSystemModuleEvent TPositionModuleStatusEventBase::SystemModuleEvent (   )  const
 

Get the type of module system event that has occurred.

Returns:
The system event type.

Friends And Related Function Documentation

friend class RPositionServer [friend]
 

Field Documentation

TPositionModuleId TPositionModuleStatusEventBase::iModuleId [protected]
 

The module ID causing the event.

TModuleEvent TPositionModuleStatusEventBase::iOccurredEvents [protected]
 

A bitmask of the events which occurred.

TModuleEvent TPositionModuleStatusEventBase::iRequestedEvents [protected]
 

A bitmask of the requested events.

TSystemModuleEvent TPositionModuleStatusEventBase::iSystemModuleEvent [protected]
 

System level module status events.

The documentation for this class was generated from the following file:
Copyright © Nokia Corporation 2001-2008
Back to top