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