/*

* Copyright (c) 2006 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: 

*     GSM-specific incoming state implementation.

*

*/

#ifndef CPHONEINCOMING_H

#define CPHONEINCOMING_H

// INCLUDES

#include "cphonestateincoming.h"

// FORWARD DECLARATIONS

class CPhoneState;

class TPhoneCmdParamBoolean;

// CLASS DECLARATION

/**

*  GSM-specific incoming state implementation.

*/

class CPhoneIncoming : public CPhoneStateIncoming

    {

    public:  

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CPhoneIncoming();

        /**

        * Creates the Incoming state class

        * @param aStateMachine: a state machine

        * @param aViewCommandHandle: handle to the PhoneUIView

        * @return an instance of class CPhoneEmergency

        */

        static CPhoneIncoming* NewL( 

            MPhoneStateMachine* aStateMachine, 

            MPhoneViewCommandHandle* aViewCommandHandle,

            MPhoneCustomization* aPhoneCustomization );

        /**

        * A message handling function for Phone Engine messages

        * @param aMessage Message from Phone Engine

        * @param aCallId Call id the message concerns

        */

        IMPORT_C void HandlePhoneEngineMessageL(

            const TInt aMessage, 

            TInt aCallId );    

        /**

        * HandleError

        * Implements error handling framework

        * @param aErrorInfo: the error info

        */

        IMPORT_C virtual void HandleErrorL( 

            const TPEErrorInfo& aErrorInfo ); 

    protected:

        /**

        * By default EPOC constructor is private.

        */

        IMPORT_C CPhoneIncoming( 

            MPhoneStateMachine* aStateMachine, 

            MPhoneViewCommandHandle* aViewCommandHandle,

            MPhoneCustomization* aPhoneCustomization );

        /**

        * ConstructL()

        */

        IMPORT_C virtual void ConstructL();

        /**

        * Handles long hash key

        */

        virtual void HandleLongHashL();

    private:

        /**

        * A message handling function for EPEMessageIncoming

        * @param aCallId: the call id of the call

        */

        void HandleIncomingL( TInt aCallId );

        /**

        * Display Incoming Call

        * @param aCallid call id

        * @param aCommandParam

        */

        void DisplayIncomingCallL( 

            TInt aCallId, 

            const TPhoneCmdParamBoolean aCommandParam );

        /**

        * Get allow waiting call header value.

        * @param aCommandParam

        */

        void AllowShowingOfWaitingCallHeaderL( 

            TPhoneCmdParamBoolean& aCommandParam );

    private:

        // call id of new waiting call

        TInt iWaitingCallId;

    };

#endif // CPHONEINCOMING_H

// End of File