/*
* Copyright (c) 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:  A list of CVCommandUiEntry-objects
*
*/


#ifndef CVCOMMANDUIENTRYARRAY_H
#define CVCOMMANDUIENTRYARRAY_H

// INCLUDES
#include <vcommandapi.h>
#include "vcommanduientry.h"

/** Array of pointers to CVCommandUiEntrys */
typedef RPointerArray<CVCommandUiEntry> RVCommandUiEntryArray;

/**
* Non-modifiable list of CVCommandUiEntrys
*/
class CVCommandUiEntryArray : public CBase
	{
	public:
		/** 
		* Constructs the non-modifiable CVCommandUiEntryArray
		* @param aSource Commands to store. CVCommandUiEntryArray makes
		*        copies of them. Ownership is passed to this class.
		*/
		static CVCommandUiEntryArray* NewL( CVCommandArray* aArray );
		
		/**
		* Destructor
		*/
        virtual ~CVCommandUiEntryArray();
		
		/**
		* Returns the reference to the command stored in this
		* CVCommandUiEntryArray
		* @param The position of the object pointer within the array. This
		*        value must not be negative and must not be greater than the
		*        number of objects currently in the array, otherwise the
		*        operator raises a USER-130 panic.
		* @return Unmodifiable reference to CVCommandUiEntry
		*/
		const CVCommandUiEntry& At( TInt aIndex ) const;
		
		/**
		* Equivalent to the operator At
		* @see At()
		*/
		const CVCommandUiEntry& operator[]( TInt aIndex ) const;

		/** 
		* Returns the number of commands
		* @return TInt The number of voice commands
		*/
		TInt Count() const;
		
		/*
		* Creates a copy of this object. Ownership is passed to the caller.
		* @return CVCommandUiEntryArray* Pointer to a CVCommandUiEntryArray
		*         object
		*/
		CVCommandUiEntryArray* CloneL();
		
	private:
	
	    /**
        * Constructor
        */
	    CVCommandUiEntryArray( CVCommandArray* aArray );
	
	    /**
        * Symbian C++ default constructor.
        */ 
		void ConstructL();
		
	private:
	
		CVCommandArray*        iCommands;
        
        RVCommandUiEntryArray  iListBoxCommands;
	};
	
#endif  // CVCOMMANDUIENTRYARRAY_H

// End of File