/*

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

*     Startup state implementation.

*

*/

#ifndef CPHONESTATESTARTUP_H

#define CPHONESTATESTARTUP_H

// INCLUDES

#include "cphonestate.h"

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

*  Startup state

*/

class CPhoneStateStartup : public CPhoneState

    {

    public:  

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CPhoneStateStartup();

        /**

        * Creates the Startup state class

        * @param aStateMachine: a state machine

        * @param aViewCommandHandle: handle to the PhoneUIView

        * @return an instance of class CPhoneStateStartup

        */

        IMPORT_C static CPhoneStateStartup* 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 );       

        IMPORT_C void HandleKeyMessageL(

            TPhoneKeyEventMessages aMessage,

            TKeyCode aCode );

        IMPORT_C void HandleKeyEventL( 

                const TKeyEvent& aKeyEvent, 

                TEventCode aEventCode );

        /**

        * Handles startup of the phone application 

        */

        IMPORT_C virtual void HandlePhoneStartupL();

        /**

         * Indicates when the Idle app is in the foreground.

         */

        IMPORT_C virtual void HandleIdleForegroundEventL();

        protected:

        /**

        * ConstructL()

        */

        IMPORT_C virtual void ConstructL();

        /**

        * By default EPOC constructor is private.

        */

        IMPORT_C CPhoneStateStartup( 

            MPhoneStateMachine* aStateMachine, 

            MPhoneViewCommandHandle* aViewCommandHandle,

            MPhoneCustomization* aPhoneCustomization );        

    private:

        /**

        * Passes create number entry command forward if NE can be created.

        */

        IMPORT_C void HandleCreateNumberEntryL( const TKeyEvent& aKeyEvent,

                TEventCode aEventCode );

        /**

         * Plays DTMF tone for key event 

         * */

        IMPORT_C void HandleDtmfKeyToneL( const TKeyEvent& aKeyEvent,

                TEventCode aEventCode );

        /**

        * A message handling function for message EPEMessagePEConstructionReady.

        * @param aCallId: the call id of the call

        */

        void HandlePEConstructionReadyL( TInt aCallId );

        /**

        * Starts to shows note.

        */

        static TInt DoShowNoteL( TAny* aAny );

        /**

        * Create and show appropriate note AFTER idle callback

        * if necessary.

        */

        void CreateAndShowNoteAfterIdle();

    protected: // Data

        // Provides phone engine startup status

        TBool iPEReady;

    private: // Data

        // Provides phone application startup status

        TBool iPhoneReady;

        // Ownded: idle object to create note.

        CIdle* iCreateNote;

    };

#endif // CPHONESTATESTARTUP_H

// End of File