/*

* Copyright (c) 2002-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:  Holds the array of CFileManagerFolderEntry

*

*/

#ifndef CFILEMANAGERFOLDERARRAY_H

#define CFILEMANAGERFOLDERARRAY_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS

#ifndef RD_MULTIPLE_DRIVE

class CFileManagerFolderEntry;

#endif // RD_MULTIPLE_DRIVE

class CFileManagerUtils;

// CLASS DECLARATION

/**

*  Array of CFileManagerFolderEntry's

*

*  @lib FileManagerEngine.lib

*  @since 2.0

*/

NONSHARABLE_CLASS(CFileManagerFolderArray) : public CBase

    {

    public:

        /**

        * Two-phased constructors.

        */        

#ifdef RD_MULTIPLE_DRIVE

        static CFileManagerFolderArray* NewL( CFileManagerUtils& aUtils );

#else // RD_MULTIPLE_DRIVE

        static CFileManagerFolderArray* NewL(

            TInt aResId, CFileManagerUtils& aUtils );

#endif // RD_MULTIPLE_DRIVE

        /**

        * Is the given folder in the default folder list

        * @since 2.0

        * @param aFolderName folder which is compared to default folder list

        * @return ETrue if the given folder is in list, EFalse if not

        */

        TBool Contains( const TDesC& aFolderName );

        /**

        * Create folders from array

        * @since 3.2

        * @param aDrive Drive which default folders are created

        * @param aForced Selects forced or normal creation

        */

        void CreateFolders(

            const TInt aDrive = KErrNotFound,

            const TBool aForced = ETrue );

        /**

        * Destructor.

        */

        ~CFileManagerFolderArray();

    private:

        /**

        * C++ default constructor.

        */

        CFileManagerFolderArray( CFileManagerUtils& aUtils );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL( TInt aResId );

#ifndef RD_MULTIPLE_DRIVE

        /**

        * Goes through the array of CFileManagerEntry's and tries to 

        * lookup if the given folder is in the array.

        * @since 2.0

        * @return CFileManagerFolderEntry if found, otherwise NULL.

        */

        CFileManagerFolderEntry* FindFolder( const TDesC& aFolderName );

#endif // RD_MULTIPLE_DRIVE

        void DoCreateFoldersL( const TInt aDrive );

    private: // Data

        // Ref: Reference to utils

        CFileManagerUtils& iUtils;

        // Own: For checking if folder creation has been done or not

        TUint iCreateCheckMask;

#ifndef RD_MULTIPLE_DRIVE

        // Own: Array of CFileManagerFolderEntry's

        RPointerArray< CFileManagerFolderEntry > iFolderArray;

        // Own: Indicates if folder array has been sorted

        TBool iSorted;

#endif // RD_MULTIPLE_DRIVE

    };

#endif      // CFILEMANAGERFOLDERARRAY_H

// End of File