Collapse all Symbian^3 Application 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???

SetCall(MCCECall &)

void

SetCall

(

MCCECall &

aCall

)

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

Parameters

MCCECall & aCall

SetMissedCall(TBool)

void

SetMissedCall

(

TBool

aMissed

)

[pure virtual]

Sets Missed call indicator.

Parameters

TBool aMissed

UnattendedTransferTarget()

const TPEPhoneNumber &

UnattendedTransferTarget

(

)

const

Returns transfer target from last received unattended transfer request.

Member Data Documentation

MCCECall * iCall

MCCECall *

iCall

[protected]

MCCECallObserver::TCCECallControlCaps iControlCaps

MCCECallObserver::TCCECallControlCaps

iControlCaps

[protected]

TPEPhoneNumber iDialledNumber

TPEPhoneNumber

iDialledNumber

[protected]

TTimeIntervalSeconds iDuration

TTimeIntervalSeconds

iDuration

[protected]

TPEPhoneNumber iTransferTarget

TPEPhoneNumber

iTransferTarget

[protected]

Transfer target from previous last unattended transfer reqeust.