--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/voiceui/voiceuivoicerecognition/inc/vuictutorial.h Wed Sep 01 12:29:17 2010 +0100
@@ -0,0 +1,145 @@
+/*
+* 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