/*

* Copyright (c) 2008-2009 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:    This class browses file system

*

*/

#ifndef C_GLXCOLLECTIONPLUGINALBUMS_H

#define C_GLXCOLLECTIONPLUGINALBUMS_H

// INCLUDES

#include <e32cmn.h>

#include "glxcollectionpluginbase.h"

/**

 * @internal reviewed 14/06/2007 by Alex Birkett

 */

// FORWARD DECLARATIONS

// CONSTANTS

const TInt KGlxCollectionAlbumLevel = KGlxCollectionRootLevel + 1;

const TInt KGlxCollectionAlbumContentsLevel = KGlxCollectionRootLevel + 2;

const TInt KGlxCollectionAlbumContentsFSLevel = KGlxCollectionRootLevel + 3;

// CLASS DECLARATION

/**

 *  CGlxCollectionPluginAlbums class 

 *

 *  Plug-in basically provides browsing.

 *	@ingroup collection_component_design

 */

NONSHARABLE_CLASS(CGlxCollectionPluginAlbums) : public CGlxCollectionPluginBase

    {

public: // Constructors and destructor

	/**

    * Two-phased constructor

    *

    * @param aObs observer

    * @return object of constructed

    */

    static CGlxCollectionPluginAlbums* NewL(TAny* aObs);

    /**

    * Destructor

    */

    ~CGlxCollectionPluginAlbums();

private:

	/**

	 * Checks to see if any additional attributes are required to construct required

	 * CPI specific attribute

	 *

	 * @param aCpiAttribute CPI specific attribute to be constructed later

	 * @param aAttributeArray modifiable list of attributes to be retrieved from data source

	 */	 

	/**

	 * Modifies the response to include all requested CPI specific attributes or Leaves.

	 *

	 * @param aResponse Data Source constructed response to which CPI specific attributes should be added (also contains any required data)

	 * @param aCpiAttributes list of CPI specific attributes to be constructed

	 * @param aMediaIds list of CPI specific media Ids

	 */	 

	void HandleCpiAttributeResponseL(CMPXMedia* aResponse, TArray<TMPXAttribute> aCpiAttributes, TArray<TGlxMediaId> aMediaIds);

	TBool IsUpdateMessageIgnored(CMPXMessage& aMessage);

	/**

	 * Modifies the response to include all requested CPI specific attributes or Leaves.

	 *

	 * @param aResponse Data Source constructed response to which CPI specific attributes should be added (also contains any required data)

	 * @param aCpiAttributes list of CPI specific attributes to be constructed

	 * @param aMediaId CPI specific media Id

	 */	 

    void HandleCpiAttributeResponseL(CMPXMedia* aResponse, TArray<TMPXAttribute> aCpiAttributes, TGlxMediaId aMediaId);

    TGlxFilterProperties DefaultFilter(TInt aLevel);

private: 

    /**

    * Constructor

    * @param aObs MMPXCollectionPluginObserver instance

    */

    CGlxCollectionPluginAlbums(MMPXCollectionPluginObserver* aObs);

    void ConstructL();

    };

#endif      // C_GLXCOLLECTIONPLUGINALBUMS_H