Collapse all Symbian^3 Product Developer Library

CPESingleCallObserver Class Reference

class CPESingleCallObserver : public CPECall

Create call handling requests to Call Command object CallHandling.lib

Since: Series60_4.0

Inherits from

CPESingleCallObserver
- CPECall
  - CBase

Public Member Functions
MCCECall &	Call()
IMPORT_C void	CallCapsChanged(const MCCECallObserver::TCCECallControlCaps)
IMPORT_C void	CallDurationChanged(const TTimeIntervalSeconds)
IMPORT_C void	CallEventOccurred(const MCCECallObserver::TCCECallEvent)
IMPORT_C void	CallStateChanged(const CCPCall::TCallState)
IMPORT_C void	CallStateChangedWithInband(const CCPCall::TCallState)
IMPORT_C void	ErrorOccurred(const TCCPError)
const CDesC8Array *	ForwardAddressChoices()
void	GetCallControlCaps(MCCECallObserver::TCCECallControlCaps &)
void	GetCallDuration(TTimeIntervalSeconds &)
IMPORT_C void	HandleTransfer(const TBool, const TDesC &)
void	SetCall(MCCECall &)
void	SetMissedCall(TBool)
const TPEPhoneNumber &	UnattendedTransferTarget()

Protected Member Functions
	CPESingleCallObserver(MPEMessageSender &)
	~CPESingleCallObserver()

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()
	CPECall::CPECall(MPEMessageSender &)
	CPECall::GetCallId()const
	CPECall::GetCallState()const
	CPECall::GetErrorCode(TInt &)const
	CPECall::SendErrorMessage(const TInt)
	CPECall::SendMessage(const MEngineMonitor::TPEMessagesFromPhoneEngine)
	CPECall::SetCallId(const TInt)
	CPECall::SetCallState(const TPEState)
	CPECall::~CPECall()

Protected Attributes
MCCECall *	iCall
MCCECallObserver::TCCECallControlCaps	iControlCaps
TPEPhoneNumber	iDialledNumber
TTimeIntervalSeconds	iDuration
TPEPhoneNumber	iTransferTarget

Inherited Attributes
	CPECall::iCallId
	CPECall::iCallState
	CPECall::iErrorCode
	CPECall::iOwner

Constructor & Destructor Documentation

CPESingleCallObserver(MPEMessageSender &)

CPESingleCallObserver

(

MPEMessageSender &

aOwner

)

[protected]

C++ default constructor.

Parameters

MPEMessageSender & aOwner

~CPESingleCallObserver()

~CPESingleCallObserver

(

)

[protected, virtual]

Destructor.

Member Functions Documentation

Call()

MCCECall &

Call

(

)

Returns the reference to the call object handle. Handle is owned by a derived object.

CallCapsChanged(const MCCECallObserver::TCCECallControlCaps)

IMPORT_C void

CallCapsChanged

(

const MCCECallObserver::TCCECallControlCaps

aCaps

)

Notifies observer about the changes in call control caps.

Since: S60 v3.2

Parameters

const MCCECallObserver::TCCECallControlCaps aCaps

Contains updated call control capability flags return none

CallDurationChanged(const TTimeIntervalSeconds)

IMPORT_C void

CallDurationChanged

(

const TTimeIntervalSeconds

aDuration

)

Notifies observer the change in call duration.

Since: S60 v3.2

Parameters

const TTimeIntervalSeconds aDuration

Duration of the call in seconds return none

CallEventOccurred(const MCCECallObserver::TCCECallEvent)

IMPORT_C void

CallEventOccurred

(

const MCCECallObserver::TCCECallEvent

aEvent

)

An event for the call has occurred. TODO: the observer need to verify event correcness.

Since: S60 v3.2

Parameters

const MCCECallObserver::TCCECallEvent aEvent

Occurred call event return none

CallStateChanged(const CCPCall::TCallState)

IMPORT_C void

CallStateChanged

(

const CCPCall::TCallState

aState

)

Call state notificfation. TODO: The observer need to verify the correctness of given state. CCE will do at least basic call state change checking but also the client needs to verify the correctness.

Since: S60 v3.2

Parameters

const CCPCall::TCallState aState

New state of the call return none

CallStateChangedWithInband(const CCPCall::TCallState)

IMPORT_C void

CallStateChangedWithInband

(

const CCPCall::TCallState

aState

)

The state of the call has changed with inband tone, meaning network is not playing the tone relating to the state.

Since: S60 3.2

Parameters

const CCPCall::TCallState aState

Call state.

ErrorOccurred(const TCCPError)

IMPORT_C void

ErrorOccurred

(

const TCCPError

aError

)

Call errors are notified using this interface.

Since: S60 v3.2

Parameters

const TCCPError aError

Occurred error as integer, return none

ForwardAddressChoices()

const CDesC8Array *

ForwardAddressChoices

(

)

const

Returns array of possible addresses from the received call forward request or NULL if addresses are not available.

GetCallControlCaps(MCCECallObserver::TCCECallControlCaps &)

void

GetCallControlCaps

(

MCCECallObserver::TCCECallControlCaps &

aCallControlCaps

)

const

Returns call control capabilities

Parameters

MCCECallObserver::TCCECallControlCaps & aCallControlCaps

call control capabilities

GetCallDuration(TTimeIntervalSeconds &)

void

GetCallDuration

(

TTimeIntervalSeconds &

aDuration

)

Returns call duration time

Parameters

TTimeIntervalSeconds & aDuration

the duration value of the call

HandleTransfer(const TBool, const TDesC &)

IMPORT_C void	HandleTransfer	(	const TBool	aAttended,
			const TDesC &	aDestination
		)

Notifies observer about transfer made by remote end

Since: S60 v3.2

Parameters

const TBool aAttended	ETrue: if transfer type is attended, EFalse: type is unattended
const TDesC & aDestination	Address where the call is to be transferred. Given as received in CCE observer needs to verify the address, e.g. it can be KNullDesC. TODO anonymous transfer target - quess cannot be occurring? A-B -> B-C, C has requested anonymity in network???