/*

* Copyright (c) 2002-2005 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description: Declaration of CPhoneHandlerControl class.

*

*/

#ifndef CPHONEHANDLERCONTROL_H

#define CPHONEHANDLERCONTROL_H

//  INCLUDES

#include "phonehandlerservice.h" 

#include <RemConExtensionApi.h> 

#include <RemConCallHandlingTargetObserver.h> 

#include <e32base.h>

#include <phclttypes.h> 

#include <e32property.h> 

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

// CLASS DECLARATION

class CRemConInterfaceSelector;

class CRemConCallHandlingTarget;

class CPhoneHandlerResponse;

class CPhoneHandlerCallState;

/**

* Receives call handling related key presses from accessories and executes 

* them.

*

*  @lib PhoneCmdHandler

*  @since S60 3.1

*/

NONSHARABLE_CLASS( CPhoneHandlerControl ) : public CBase,

                                            public MRemConCallHandlingTargetObserver

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CPhoneHandlerControl* NewL( 

            CRemConInterfaceSelector* aIfSelector = NULL );

        /**

        * Destructor.

        */

        virtual ~CPhoneHandlerControl();

    public: // New functions

        /**

        * Returns phone number for dial or speed dial.

        * @since S60 3.1

        * @param void

        * @return TPhCltTelephoneNumber phone number

        */

        const TPhCltTelephoneNumber& TelephoneNumber() const;

        /**

        * Returns voice dial status for voice dial.

        * @since S60 3.1

        * @param void

        * @return TBool status

        */

        const TBool& VoiceDialStatus() const;

        /**

        * Returns CHLD command for multiparty call.

        * @since S60 3.1

        * @param void

        * @return TInt CHLD command

        */

        const TInt& ChldCommand() const;

        /**

        * Returns CHLD call number for multiparty call.

        * @since S60 3.1

        * @param void

        * @return TInt CHLD command number

        */

        const TInt& ChldCallNumber() const;

        /**

        * Returns DTMF tone to be sent.

        * @since S60 3.1

        * @param void

        * @return TChar DTMF tone

        */

        const TChar& Tone() const;

        /**

        * Returns reference to API used to communicate with accessory who 

        * initiated key press.

        * @since S60 3.1

        * @param void

        * @return CRemConCallHandlingTarget& reference to API

        */  

        CRemConCallHandlingTarget& CommandInitiator() const;

        /**

        * Informs the latest call state.

        * @since S60 3.1

        * @param aState Call state from KTelephonyCallState P&S key

        * @return void

        */

        void NotifyCallState( const TInt aState );

        /**

        * Get iSwitchCall flag, if this flag is ETrue, it means

        * "Send" key in remote target is pressed in multiparty call,

        * otherwise EFalse

        * @since S60 3.1

        * @return TBool

        */

        TBool SwitchCall();

    public: // Functions from base classes

    protected:  // New functions

    protected:  // Functions from base classes

    private:

        /**

        * C++ default constructor.

        */

        CPhoneHandlerControl();

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL( CRemConInterfaceSelector* aIfSelector = NULL );

        /**

        * From MRemConCallHandlingTargetObserver. Answer an incoming phone call.

        */

        virtual void AnswerCall();

        /**

        * From MRemConCallHandlingTargetObserver. End an incoming/ongoing 

        * phone call.

        */

        virtual void EndCall();

        /**

        * From MRemConCallHandlingTargetObserver. Answer an incoming phone call, 

        * or end an ongoing call according to call status. 

        */

        virtual void AnswerEndCall();

        /**

        * From MRemConCallHandlingTargetObserver. Make a voice call.

        */

        virtual void VoiceDial( const TBool aActivate );

        /**

        * From MRemConCallHandlingTargetObserver. Redial last phone call.

        */

        virtual void LastNumberRedial();

        /**

        * From MRemConCallHandlingTargetObserver. Dial a phone call.

        */

        virtual void DialCall( const TDesC8& aTelNumber );

        /**

        * From MRemConCallHandlingTargetObserver. Make multiparty call.

        */

        virtual void MultipartyCalling( const TDesC8& aData );

        /**

        * Generates DTMF signal.

        */

        virtual void GenerateDTMF( const TChar aChar );

        /**

        * From MRemConCallHandlingTargetObserver. Make a speed dial call.

        */

        virtual void SpeedDial( const TInt aIndex );

        /**

        * Starts processing service corresponding to key press.

        */

        void StartProcessing( 

            const TRemConExtCallHandlingApiOperationId aOperation );

        /**

        * Creates service.

        */

        MPhoneHandlerService* CreateServiceL( 

            const TRemConExtCallHandlingApiOperationId aOperation );

        /**

        * Returns call status.

        */

        void CallStatusL( RPhone::TLineInfo& aLineInfo );

    private:    // Data

        // Provides e.g. service to listen accessory key presses.

        CRemConInterfaceSelector* iInterfaceSelector;   // owned

        //  API notifying PhoneCmdHandler about call handling key presses.

        CRemConCallHandlingTarget* iTarget; // owned

        // Phone number for dial call/speed dial.

        TPhCltTelephoneNumber iTelNumber;

        // Voice recognition status

        TBool iActivate;

        // Multiparty call command

        TInt iChldCommand;

        // Multiparty call number

        TInt iChldCallNumber;

        // Type of DTMF tone

        TChar iChar;

        //  Speed dial index.

        TInt iIndex;

        // Sends responses to RemCon FW

        CPhoneHandlerResponse* iResponse;

        // Interface to P&S key that returns call state

        RProperty iProperty;

        // Previous call state

        TInt iPrevState;

        // Number of active calls

        // Used to determine whether there's a multicall case when call state

        TInt iActiveCalls;

        // switch phonecall by press "Send" key

        TBool iSwitchCall;

        // Listens to phone call state changes.

        CPhoneHandlerCallState* iCallStateObserver;

    public:     // Friend classes

    protected:  // Friend classes

    private:    // Friend classes

    };

#endif      // CPHONEHANDLERCONTROL_H   

// End of File