Collapse all Symbian^3 Application Developer Library

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

CCallInformation
- CBase

Public Member Functions
	~CCallInformation ()
IMPORT_C void	CancelNotification ()
IMPORT_C CCallInfoIter &	GetCallsL ()
IMPORT_C TBool	IsCallInState ( CCPCall::TCallState )
IMPORT_C CCallInformation *	NewL ()
IMPORT_C void	NotifyCallInformationChanges ( MCallInformationObserver &)

Private Member Functions
	CCallInformation ()
void	ConstructL ()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	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()

Private Attributes
CCallInformationImpl *	iImpl

Constructor & Destructor Documentation

CCallInformation()

CCallInformation

(

)

[private]

~CCallInformation()

~CCallInformation

(

)

[virtual]

Destructor.

Member Functions Documentation

CancelNotification()

IMPORT_C void

CancelNotification

(

)

Used to cancel previously placed NotifyCallInformationChanges call.

Since: S60 v5.1

ConstructL()

void

ConstructL

(

)

[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 TBool

IsCallInState

(

CCPCall::TCallState

aState

)

const

Returns information whether call in given state exist.

Since: S60 v5.2

Parameters

CCPCall::TCallState aState

Specifies a call state that is used as a search key.

NewL()

IMPORT_C CCallInformation *

NewL

(

)

[static]

Two-phased constructor.

NotifyCallInformationChanges(MCallInformationObserver &)

IMPORT_C void

NotifyCallInformationChanges

(

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 & aObserver

Observer for notifications.

Member Data Documentation

CCallInformationImpl * iImpl

CCallInformationImpl *

iImpl

[private]