/*
* 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:  Handles tutorial mode resources and dialog showing
*
*/


#ifndef VUICTUTORIAL_H
#define VUICTUTORIAL_H

// INCLUDES
#include "vuictutorialmessagedialog.h"


// CLASS DECLARATION
/**
* Handles tutorial mode resources and dialog showing
*/
NONSHARABLE_CLASS( CTutorial ) : public CBase
{
    public:     // Constructors and destructor
       
        /**
        * Symbian two-phased constructor.
        */
        static CTutorial* NewL();

        /**
        * Destructor.
        */
        virtual ~CTutorial();
        
    public:     // Enumerations
    
        enum TTutorialState
            {
            EIntroState,
            ECommandState,
            EDialState,
            EOtherState,
            ETryState,
            EBestState,
            EActivationState,
            EErrorState,
            EFinishedState            
            };
                                
    public:     // New functions
    
        /**
        * Creates a message dialog
        */
        void CreateMessageL();
        
        /**
        * Creates and shows a message dialog
        * @return Keycode of the pressed key
        */
        TInt CreateAndShowMessageL();
        
        /**
        * Shows a message dialog
        * @param aDeviceLockMode ETrue to set tutorial in device lock mode
        * @return Keycode of the pressed key
        */
        TInt ShowMessageL( TBool aDeviceLockMode = EFalse );
        
        /**
        * Destroys created message dialog
        */
        void DestroyMessage();
        
        /**
        * Returns the current state of the tutorial
        * @return One of the TTutorialState types
        */
        TTutorialState GetTutorialState();
        
        /**
        * Sets the next shown message to be an error message
        */
        void ErrorState();
                                
    private:

        /**
        * Check's if the tutorial mode is enabled
        * @return ETrue if tutorial mode is enabled else EFalse
        */
        TBool IsTutorialModeEnabled();
        
        /**
        * Sets the first time mode off
        */
        void DisableFirstTimeMode();

        /**
        * C++ default constructor.
        */
        CTutorial();
        
        /**
        * Symbian OS 2nd phase constructor.
        */
        void ConstructL();
                       
        /**
        * Loads tutorial and first time mode settings from CenRep
        */
        void LoadSettingsL();

        /**
        * Saves tutorial and first time mode settings to CenRep
        */
        void SaveSettingsL();
        
    private:    // Data
    
        // Actual tutorial mode
        TBool                       iTutorialMode;
        
        // First time tutorial mode
        TBool                       iFirstTimeMode;
        
        // For handling internal logics
        TTutorialState              iState;
        
        // Message dialog
        CTutorialMessageDialog*     iDlg;
};

#endif  // VUICTUTORIAL_H

// End of File