voiceui/voiceuivoicerecognition/inc/vuiccontactresultsstate.h
branchRCL_3
changeset 19 e36f3802f733
parent 0 bf1d17376201
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/voiceui/voiceuivoicerecognition/inc/vuiccontactresultsstate.h	Wed Sep 01 12:29:17 2010 +0100
@@ -0,0 +1,167 @@
+/*
+* Copyright (c) 2006-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:  
+*
+*/
+
+
+#ifndef VUICCONTACTRESULTSSTATE_H
+#define VUICCONTACTRESULTSSTATE_H
+
+// INCLUDES
+#include "vuicstate.h"
+
+// FORWARD DECLARATIONS
+
+class CNBestListDialog;
+class CDesC16ArrayFlat;
+class MNssTag;
+class CNssVASDBMgr;
+class MNssTagMgr;
+
+// CLASS DECLARATION
+/**
+* COMMENT
+*/
+NONSHARABLE_CLASS( CContactResultsState ) : public CState
+{
+    public:     // Constructors and destructor
+
+        /**
+        * Symbian two-phased constructor.
+        */
+        static CContactResultsState* NewL( CDataStorage& aDataStorage, CUiModel& aUiModel );
+
+        /**
+        * Destructor.
+        */
+        virtual ~CContactResultsState();
+                                
+    public:     // New functions
+    
+        /**
+        * Handles received event
+        * @param Event to be handled
+        */
+        virtual void HandleEventL( TInt aEvent );
+        
+        /**
+        * Executes the state functionality
+        */
+        virtual void ExecuteL();
+         
+    protected:  // New functions
+        
+        /**
+        * C++ default constructor.
+        */
+        CContactResultsState( CDataStorage& aDataStorage, CUiModel& aUiModel );
+        
+        /**
+        * Symbian OS 2nd phase constructor.
+        */
+        virtual void ConstructL();
+        
+        /**
+        * Handles timed event
+        */
+        void DoTimedEventL();
+        
+    private:    // Functions        
+        
+        /**
+        * Handles keypress event
+        * @return ETrue if event was handled else EFalse
+        */
+        TBool HandleKeypressL();
+        
+        /**
+        * Plays currently selected name from the n-best list with TTS
+        */
+        void PlaySelectedNameL();
+        
+        /**
+        * Creates contact info array
+        */
+        void CreateContactInfoArrayL();
+        
+        /**
+        * Compares given tag and currently selected tag names
+        * @param aTag Tag that is used in comparison
+        * @return ETrue if names match else EFalse
+        */
+        TBool CompareContactNamesL( MNssTag* aTag );
+        
+        /**
+        * Checks if given tag exists in taglist
+        * @param aTag Tag that is searched
+        * @return ETrue if tag exists else EFalse
+        */
+        TBool CheckIfAlreadyAdded( MNssTag* aTag );
+        
+        /**
+        * Creates new items array. Ownership is transferred to caller.
+        * @return Items array     
+        */
+        CDesC16ArrayFlat* CreateItemsArrayL();
+       
+        /**
+        * Fills buffer with dial tag information
+        * @param aTag Tag containing all needed information
+        * @param aBuffer Buffer to be filled
+        */
+        void FillDialContextBufferL( MNssTag* aTag, TDes& aBuffer );
+       
+        /**
+        * Gets the right icon for contact
+        * @param aIconId The type of contacts icon
+        * @return Icon type   
+        */
+        TPtrC GetContactIconType( TFieldType aIconId );
+        
+        /**
+        * Selects currently active tag from n-best list
+        */
+        void SelectTag();
+                
+    private:    // Data
+    
+        enum TInternalState
+            {
+            ENotStarted,
+            EStarted,
+            EInitialized,
+            ECompleted
+            };
+    
+        // N-best list dialog
+        CNBestListDialog*           iNBestListDialog;
+        
+        // Stores a keypress event from HandleEventL
+        TInt                        iKeypress;
+        
+        // For handling internal state logics
+        TInternalState              iInternalState;
+        
+        // For storing copies of tag pointers
+        CArrayPtrFlat<MNssTag>*     iTagList;
+        
+        // Vas stuff for handling context operations
+        CNssVASDBMgr*               iNssVasDbManager;
+        MNssTagMgr*                 iNssTagManager;
+    };
+
+#endif  // VUICCONTACTRESULTSSTATE_H
+
+// End of File