CCallInformation Class Reference

class CCallInformation : public CBase

Class to be used for receiving information about ongoing calls.

  // create the CCallInformation instance e.g. when the client component is created
  iCallInfo = CCallInformation::NewL(); 
  iCallInfo->NotifyCallInformationChanges(*iObserver);
  
  // and use it when needed. 
  CCallInfoIter& iter = iCallInfo->GetCallsL();
telephonyservice.lib
Since
S60 v5.1

Inherits from

Constructor & Destructor Documentation

CCallInformation()

CCallInformation()[private]

~CCallInformation()

~CCallInformation()[virtual]

Destructor.

Member Functions Documentation

CancelNotification()

IMPORT_C voidCancelNotification()

Used to cancel previously placed NotifyCallInformationChanges call.

Since
S60 v5.1

ConstructL()

voidConstructL()[private]

GetCallsL()

IMPORT_C CCallInfoIter &GetCallsL()

Gets the snapshot of ongoing calls. The returned reference should not be stored as member variable as it goes out of scope when there are changes in call information.

Since
S60 v5.1

IsCallInState(CCPCall::TCallState)

IMPORT_C TBoolIsCallInState(CCPCall::TCallStateaState)const

Returns information whether call in given state exist.

Since
S60 v5.2

Parameters

CCPCall::TCallState aStateSpecifies a call state that is used as a search key.

NewL()

IMPORT_C CCallInformation *NewL()[static]

Two-phased constructor.

NotifyCallInformationChanges(MCallInformationObserver &)

IMPORT_C voidNotifyCallInformationChanges(MCallInformationObserver &aObserver)

Allows a client to be notified when there are changes in current calls. There can be only one observer per CCallInformation instance.

Since
S60 v5.1

Parameters

MCallInformationObserver & aObserverObserver for notifications.

Member Data Documentation

CCallInformationImpl * iImpl

CCallInformationImpl *iImpl[private]