Collapse all Symbian^3 Product Developer Library

CPEDtmfHandling Class Reference

class CPEDtmfHandling : public CBase

Handles dtmf commands.

callhandling.lib

Since: Series60_4.0

Inherits from

CPEDtmfHandling
- CBase

Public Member Functions
	~CPEDtmfHandling()
void	CancelDtmfString()
void	ContinueDtmfSending()
IMPORT_C void	HandleDTMFEvent(const MCCEDtmfObserver::TCCEDtmfEvent, const TInt, const TChar)
IMPORT_C CPEDtmfHandling *	NewL(CPECallHandling &, MCCEDtmfInterface &)
TInt	SendDtmfString(const TDesC &)
TInt	StartDtmfTone(const TChar &)
void	StopDtmfSending()
TInt	StopDtmfTone()

Protected Member Functions
	CPEDtmfHandling(CPECallHandling &, MCCEDtmfInterface &)
IMPORT_C 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()

Protected Attributes
MCCEDtmfInterface &	iDtmfInterface
CPECallHandling &	iOwner

Constructor & Destructor Documentation

CPEDtmfHandling(CPECallHandling &, MCCEDtmfInterface &)

IMPORT_C	CPEDtmfHandling	(	CPECallHandling &	aOwner,
			MCCEDtmfInterface &	aDtmfInterface
		)	[protected]

C++ default constructor.

Parameters

CPECallHandling & aOwner
MCCEDtmfInterface & aDtmfInterface

~CPEDtmfHandling()

IMPORT_C

~CPEDtmfHandling

(

)

[virtual]

Destructor.

Member Functions Documentation

CancelDtmfString()

void

CancelDtmfString

(

)

Cancels Dtmf String sending

Since: Series60_4.0

ConstructL()

IMPORT_C void

ConstructL

(

)

[protected, virtual]

By default Symbian 2nd phase constructor is private.

ContinueDtmfSending()

void

ContinueDtmfSending

(

)

Allows a client to continue the sending of a dtmf string when it was stopped by use of 'w' char in the string

Since: Series60_4.0

HandleDTMFEvent(const MCCEDtmfObserver::TCCEDtmfEvent, const TInt, const TChar)

IMPORT_C void	HandleDTMFEvent	(	const MCCEDtmfObserver::TCCEDtmfEvent	aEvent,
			const TInt	aError,
			const TChar	aTone
		)

All the occurred DTMF events are notified through this interface

Since: S60 3.2

Parameters

const MCCEDtmfObserver::TCCEDtmfEvent aEvent	Event code
const TInt aError	Error code
const TChar aTone	tone

NewL(CPECallHandling &, MCCEDtmfInterface &)

IMPORT_C CPEDtmfHandling *	NewL	(	CPECallHandling &	aOwner,
			MCCEDtmfInterface &	aDtmfInterface
		)	[static]

Two-phased constructor.

Example usage:

 // replace <featureUID> with a real UID 

 #include <featmgr/featmgr.h>
 #include <bldvariant.hrh> // for feature definitions

 CMyClass::ConstructL()
     {
     // Sets up TLS, must be done before FeatureManager is used.
     FeatureManager::InitializeLibL();
     // Used in destructor. 
     iFeatMgrInitialized = ETrue;
     }

 CMyClass::ShowMenuL()
     {
     if ( FeatureManager::FeatureSupported( <featureUID> ) )
         {
         // Feature supported, show menu item associated with it.
         }
     }

 CMyClass::~CMyClass()
     {
     // Do not call UnInitializeLib() if InitalizeLib() leaves.
     if ( iFeatMgrInitialized )
         {
	      // Frees the TLS. Must be done after FeatureManager is used.
         FeatureManager::UnInitializeLib();  
         }
     }

Parameters

CPECallHandling & aOwner
MCCEDtmfInterface & aDtmfInterface

SendDtmfString(const TDesC &)

TInt

SendDtmfString

(

const TDesC &

aTones

)

Send dtmf string to the etel

Since: Series60_4.0

Parameters

const TDesC & aTones

dtmf string

StartDtmfTone(const TChar &)

TInt

StartDtmfTone

(

const TChar &

aTone

)

const

allows a client initiate the sending of a DTMF tone

Since: Series60_4.0

Parameters

const TChar & aTone

dtmf tone

StopDtmfSending()

void

StopDtmfSending

(

)

Allows a client to cancel the sending of a dtmf string when it was stopped by use of 'w' char in the string

Since: Series60_4.0

StopDtmfTone()

TInt

StopDtmfTone

(

)

const

allows a client terminate the sending of a DTMF tone

Since: Series60_4.0

Member Data Documentation

MCCEDtmfInterface & iDtmfInterface

MCCEDtmfInterface &

iDtmfInterface

[protected]

CPECallHandling & iOwner

CPECallHandling &

iOwner

[protected]