/*
* 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