Collapse all Symbian^3 Product Developer Library

CVccSignalLevelHandler Class Reference

class CVccSignalLevelHandler : public CTimer

Base class for signal level handling. Other classes are derived from this class.

  class CVccXXXSignalLevelHandler : public CVccSignalLevelHandler,
                                    public MXXXOtherClass

vcchotrigger.dll

Since: S60 v3.2

Inherits from

CVccSignalLevelHandler
- CTimer
  - CActive
    - CBase

Public Member Functions
	~CVccSignalLevelHandler()
void	SetParams(const TSignalLevelParams &)
void	StartL()
void	Stop()

Protected Member Functions
	CVccSignalLevelHandler(MVccSignalLevelObserver &, const TSignalLevelParams &)
void	CancelGetStrength()
void	ConstructL()
void	DisableNotifications()
void	DoCancel()
void	EnableNotificationsL()
void	GetStrength()
void	NotifyChanges(TInt32, MVccSignalLevelObserver::TSignalStrengthClass)
void	StrengthChanged()

Private Member Functions
void	RunL()

Inherited Functions
	CActive::CActive(TInt)
	CActive::Cancel()
	CActive::Deque()
	CActive::Extension_(TUint,TAny &,TAny )
	CActive::IsActive()const
	CActive::IsAdded()const
	CActive::Priority()const
	CActive::RunError(TInt)
	CActive::SetActive()
	CActive::SetPriority(TInt)
	CActive::~CActive()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CTimer::After(TTimeIntervalMicroSeconds32)
	CTimer::At(const TTime &)
	CTimer::AtUTC(const TTime &)
	CTimer::CTimer(TInt)
	CTimer::HighRes(TTimeIntervalMicroSeconds32)
	CTimer::Inactivity(TTimeIntervalSeconds)
	CTimer::Lock(TTimerLockSpec)
	CTimer::~CTimer()

Protected Member Enumerations
enum	TOperation { EOperationNone, EOperationGet, EOperationWait, EOperationComplete }
enum	TStrengthState { EStrengthUnknown, EStrengthLow, EStrengthHigh }

Inherited Enumerations
	CActive:TPriority

Protected Attributes
TBool	iNotificationsOn
MVccSignalLevelObserver &	iObserver
TOperation	iOperation
TSignalLevelParams	iParams
TStrengthState	iState
TInt32	iStrength

Inherited Attributes
	CActive::iStatus

Constructor & Destructor Documentation

CVccSignalLevelHandler(MVccSignalLevelObserver &, const TSignalLevelParams &)

CVccSignalLevelHandler	(	MVccSignalLevelObserver &	aObserver,
		const TSignalLevelParams &	aParams
	)	[protected]

C++ constructor

Since: S60 3.2

Parameters

MVccSignalLevelObserver & aObserver	Observer to be notified when signal level changes
const TSignalLevelParams & aParams	Parameters at which level notifications should be given as well the timeout how long the signal must at the specified level or above before notification is given.

~CVccSignalLevelHandler()

~CVccSignalLevelHandler

(

)

[virtual]

Destructor.

Member Functions Documentation

CancelGetStrength()

void

CancelGetStrength

(

)

[protected, pure virtual]

Cancel outstanding signal strentgh request.

Since: S60 3.2

ConstructL()

void

ConstructL

(

)

[protected]

CTimer::ConstructL()

DisableNotifications()

void

DisableNotifications

(

)

[protected, pure virtual]

Cancel the notification service

Since: S60 3.2

DoCancel()

void

DoCancel

(

)

[protected, virtual]

From CTimer::DoCancel()

EnableNotificationsL()

void

EnableNotificationsL

(

)

[protected, pure virtual]

Activate the notification service

Since: S60 3.2

GetStrength()

void

GetStrength

(

)

[protected, pure virtual]

Get the current Received Signal Strength Indicator (RSSI)

Since: S60 3.2

NotifyChanges(TInt32, MVccSignalLevelObserver::TSignalStrengthClass)

void	NotifyChanges	(	TInt32	aSignalStrength,
			MVccSignalLevelObserver::TSignalStrengthClass	aClass
		)	[protected, pure virtual]

Notifies the observer about signal level changes.

Since: S60 3.2

Parameters

TInt32 aSignalStrength
MVccSignalLevelObserver::TSignalStrengthClass aClass

RunL()

void

RunL

(

)

[private, virtual]

From CActive::RunL()

SetParams(const TSignalLevelParams &)

void

SetParams

(

const TSignalLevelParams &

aParams

)

[virtual]

Set the notification parameters

Since: S60 3.2

Parameters

const TSignalLevelParams & aParams

Notification parameters

StartL()

void

StartL

(

)

Start signal level observing

Since: S60 3.2

Stop()

void

Stop

(

)

Stop signal level observing

Since: S60 3.2

StrengthChanged()

void

StrengthChanged

(

)

[protected]

Handles singal strength changes which are notified by the signal level observer

Since: S60 3.2

Member Enumerations Documentation

Enum TOperation

Current operation mode

Enumerators

EOperationNone
EOperationGet
EOperationWait
EOperationComplete

Enum TStrengthState

Level of the signal

Enumerators

EStrengthUnknown
EStrengthLow
EStrengthHigh

Member Data Documentation

TBool iNotificationsOn

TBool

iNotificationsOn

[protected]

Flag to determine if the observing/notifications are on or off

MVccSignalLevelObserver & iObserver

MVccSignalLevelObserver &

iObserver

[protected]

Observer Not own

TOperation iOperation

TOperation

iOperation

[protected]

TSignalLevelParams iParams

TSignalLevelParams

iParams

[protected]

Parameters defining timers and signal levels

TStrengthState iState

TStrengthState

iState

[protected]

TInt32 iStrength

TInt32

iStrength

[protected]

Current signal level in dBm