/*
* Copyright (c) 2007 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:  Concrete application state classes
*
*/


#ifndef T_VTUIAPPSTATES_H
#define T_VTUIAPPSTATES_H

#include "tvtuiappstatebase.h"
#include <babitflags.h>
#include <vtengcommands.h>

class CAknQueryDialog;

/**
*  Initial application state. Responsible for startup phase 1 and
*  startup phase 2 (see EVtUiAppUiStartup in CVtUiAppUi.cpp).
*  Certain other state changes are required for phase 2 and history
*  of their reception is handled with precondition flags.
*
*  @since S60 v3.2
*/
class TVtUiStateStarting : public TVtUiAppStateBase
    {
public:
    /**
    * returns singleton instance of TVtUiStateStarting
    * @param aCtx state context
    * @param aUiStates UI states
    * @return singleton
    */
    static TVtUiStateStarting* InstanceL(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates );

public: // from TVtUiAppStateBase

    /** @see TVtUiAppStateBase */
    virtual void AppUiStartupPhase1DoneL();

    /** @see TVtUiAppStateBase */
    virtual void AppUiStartupPhase2DoneL();

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleVtEventL( TInt aEvent );

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleCommandL( const TInt aCommand );

    /** @see TVtUiAppStateBase */
    virtual TBool HandleForegroundChangedL( TBool aIsForeground );

private: // from TVtUiAppStateBase

    /** @see TVtUiAppStateBase */
    virtual void OpenL();

    /** @see TVtUiAppStateBase */
    virtual void Close();

private: // new methods

    void CheckSessionStateL();
    static TInt AsynchOpen( TAny* aAny );
    
    void DoOpenL();
    
    /** Preconditions that must be passed in order to proceed
     * to Phase 2 in startup.
     */
    enum TPreconditions
        {
        /** waiting for CLI from engine*/
        EWaitingCLI,
        /** waiting for phase1 to complete */
        EWaitingPhase1ToComplete,
        /** waiting for engine to get proper state */
        EWaitingSessionState
    };

    /**
    * Clears precondition passed as argument and checks if any
    * preconditions hold and if not proceeds to phase 2 of startup.
    */
    void CheckPhase2StartupL( const TPreconditions aClearCondition );
    
    void HandleCLIReceivedL();

private: // constructors and destructors

    // c++ constructor
    TVtUiStateStarting(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates );

    // Destructor
    virtual ~TVtUiStateStarting();

private: // data members

    // Precondition for state change to running
    TBitFlags8 iPreconditions;

    // Singleton
    static TVtUiStateStarting* iInstance;
    
    // Starts phase1 startup in state state context. Needed because
    // initial state is opened from within state context construction.
    CAsyncCallBack*     iStartCallback;
    };

/**
*  Application state that is active in normal operation.
*
*  @since S60 v3.2
*/
class TVtUiStateRunning : public TVtUiAppStateBase
    {
public:
    /**
    * returns singleton instance of TVtUiStateRunning
    * @param aCtx state context
    * @param aUiStates UI states
    * @return singleton
    */
    static TVtUiStateRunning* InstanceL(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates );

public: // from TVtUiAppStateBase

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleVtEventL( TInt aEvent );

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleCommandL( const TInt aCommand );

    /** @see TVtUiAppStateBase */
    virtual TBool HandleForegroundChangedL( TBool aIsForeground );

    /** @see TVtUiAppStateBase */
    virtual TBool PreHandleForegroundChangedL( TBool aIsForeground );
    /** @see TVtUiAppStateBase */
    virtual void HandleLayoutChangedL();

    /** @see TVtUiAppStateBase */
    virtual void StartDtmfTone( const TChar& aTone );

    /** @see TVtUiAppStateBase */
    virtual void StopDtmfTone();

    /** @see TVtUiAppStateBase */
    virtual void OpenL();

private: // from TVtUiAppStateBase
    /** @see TVtUiAppStateBase */
    virtual void Close();

private: // constructors and destructors

    // c++ constructor
    TVtUiStateRunning(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates );

    // Destructor
    virtual ~TVtUiStateRunning();

private: // new functions

    /** Requests call handling subsystem to initiate a voice call.
     * Starts shutdown of the application.
     */
    void CreateVoiceCallL();

    /** Dials emergency call and starts shutdown */
    void DialEmergencyCallL();
    
    void ShutdownWithEngineCommandL( const TInt aCommand );

private: // data members
    // singleton
    static TVtUiStateRunning* iInstance;
    // Create voice call query instance
    CAknQueryDialog* iCreateVoiceCallDlg;
    };

/**
*  Application state that is active during shutdown.
*
*  @since S60 v3.2
*/
class TVtUiStateResetting : public TVtUiAppStateBase
    {
public:
    /**
    * returns singleton instance of TVtUiStateResetting
    * @param aCtx state context
    * @param aUiStates UI states
    * @param aCommand engine command to send when resetting state activates
    * @return singleton
    */
    static TVtUiStateResetting* InstanceL(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates,
        const TVtEngCommandId aCommand = KVtEngCommandNone );

public: // from TVtUiAppStateBase

    /** @see TVtUiAppStateBase */
    virtual void AppUiStartupFailedL();

    /** @see TVtUiAppStateBase */
    virtual void ShutdownDoneL();

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleVTCommandPerformedL(
        TVtEngCommandId aCommand,
        const TInt aError );

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleVtEventL( TInt aEvent );

    /** @see TVtUiAppStateBase */
    virtual TEventResponse HandleCommandL( const TInt aCommand );

    /** @see TVtUiAppStateBase */
    virtual TBool HandleForegroundChangedL( TBool aIsForeground );

    /** @see TVtUiAppStateBase */
    virtual void HandleLayoutChangedL();

private: // from TVtUiAppStateBase

    /** @see TVtUiAppStateBase */
    virtual void OpenL();

    /** @see TVtUiAppStateBase */
    virtual void Close();

private: // constructors and destructors

    // c++ constructor
    TVtUiStateResetting(
        MVtUiStateContext& aCtx,
        TVtUiStates& aUiStates,
        const TVtEngCommandId aCommand = KVtEngCommandNone );

    // Destructor
    virtual ~TVtUiStateResetting();

private: // data members

    // Singleton
    static TVtUiStateResetting* iInstance;
    
    // Used in user originated shutdown (end active call/switch to voice)
    TVtEngCommandId iCommand;
    };

#endif // T_VTUIAPPSTATES_H