/*

* Copyright (c) 2008 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:   Implements MCUIInfoIterator API for CCUIDetailsDialog

*

*/

#ifndef C_APPMNGR2INFOITERATOR_H

#define C_APPMNGR2INFOITERATOR_H

#include <CUIDetailsDialog.h>           // SwiUI::CommonUI::MCUIInfoIterator

class CAppMngr2InfoBase;

class CDesC8Array;

enum TAppMngr2InfoType

    {

    EAppMngr2StatusInstalled,

    EAppMngr2StatusNotInstalled

    };

/**

 * CAppMngr2InfoIterator is the base class for plug-in specific data collecting

 * iterators. CAppMngr2InfoIterator derived iterators can be used to get the data

 * shown in details dialog (CCUIDetailsDialog). Details dialog shows application

 * details and certificate info.

 * 

 * @lib appmngr2pluginapi.lib

 * @since S60 v5.1

 */

class CAppMngr2InfoIterator : public CBase, public SwiUI::CommonUI::MCUIInfoIterator

    {

public:     // constructors and destructor

    /**

     * Constructs new info iterator to show details dialog.

     * 

     * @param aInfo  Reference to application or package info object

     * @param aInfoType  Type info (installed application or not installed package)

     */

    IMPORT_C CAppMngr2InfoIterator( CAppMngr2InfoBase& aInfo, TAppMngr2InfoType aInfoType );

    /**

     * Allocates memory for CDesCArrays.

     * 

     * BaseConstructL() must be called from derived ConstructL() before any other

     * leaving functions. BaseConstructL() calls SetAllFieldsL() to get all the

     * displayable details.

     */

    IMPORT_C void BaseConstructL();

    /**

     * Destructor, deletes allocated memory.

     */

    IMPORT_C ~CAppMngr2InfoIterator();

public:     // from MCUIInfoIterator

    IMPORT_C TBool HasNext() const;

    IMPORT_C void Next( TPtrC& aKey, TPtrC& aValue );

    IMPORT_C void Reset();

protected:  // new functions

    /**

     * Sets field to given value.

     * 

     * Uses StringLoader to load aResourceId and adds it to MCUIInfoIterator

     * as a new key having value aValue.

     *  

     * @param aResourceId  Resource id for MCUIInfoIterator key

     * @param aValue  Value for the key

     */

    IMPORT_C void SetFieldL( TInt aResourceId, const TDesC& aValue );

    /**

     * Sets all default fields, can be overridden in derived classes.

     * 

     * Default implementation sets name (from CAppMngr2InfoBase::Name()),

     * status (either installed or not installed), location drive (from

     * CAppMngr2InfoBase::Location()), and application/file size (from

     * CAppMngr2InfoBase::Details()). Status and location fields are set

     * using SetStatusL() and SetLocationL() functions, so that they can

     * be overridden separately. Finally calls SetOtherFieldsL() to set

     * other fields, if derived class has some additional fields that

     * are not covered here. 

     */

    IMPORT_C virtual void SetAllFieldsL();

    /**

     * Sets status (installed or not installed) based on aInfoType

     * defined in constructor. This function can be overridden in

     * derived classes.

     */

    IMPORT_C virtual void SetStatusL();

    /**

     * Sets location drive based on CAppMngr2InfoBase::Location().

     * This function can be overridden in derived classes.

     */

    IMPORT_C virtual void SetLocationL();

    /**

     * Sets other possble fields, default implemenation is empty.

     * This function can be overridden in derived classes.

     */

    IMPORT_C virtual void SetOtherFieldsL();

protected:  // data

    CAppMngr2InfoBase& iInfo;

    TAppMngr2InfoType iInfoType;

    TInt iCurrentIndex;

    CDesCArray* iKeys;

    CDesCArray* iValues;

    };

#endif  // C_APPMNGR2INFOITERATOR_H