/*

* 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:    CGlxContainerListBinding This class holds the list of 

*                 tags/albums associated with a media item

*

*/

#ifndef _GLXCONTAINERLISTBINDING_H_

#define _GLXCONTAINERLISTBINDING_H_

#include <e32base.h>                  // Container Base Class

#include <mpxattribute.h>             // lib mpxcommon.lib

#include <mglxmedialistobserver.h>    // Observes for changes in media list

#include "glxattributecontext.h"      // Fetch context to retrieve thumbnails

#include "glxbinding.h"               // holds the bindings required to populate the visual item

#include "glxustringconverter.h"      // class that converts the symbian types to UString type

class CMPXCollectionPath;             //  mpxcommon.lib

class CGlxAttributeContext;           // Fetch context to retrieve thumbnails

class MGlxMediaList;                  // lib glxmedialists.lib

class TGlxMedia;                      // media item in the item pool

namespace Alf

    {

    class IAlfVariantType;            // lib alfwidgetmodel.lib

    class MulVisualItem;              // Client need to use this class to add data in data model

    }

namespace osncore

    {

    class UString;                    // encapsulates utf-8 encoded string

    }

/**

 * CGlxContainerListBinding This class holds the list of tags/albums associated with a media item

 */

NONSHARABLE_CLASS( CGlxContainerListBinding ) : public CGlxSingleTagBinding, 

        public MGlxMediaListObserver

    {

public:

	/**

	 * NewL Two phase construction

	 */

	static CGlxContainerListBinding* NewL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

		const CMPXCollectionPath& aPath );

	/**

	 * NewLC Two phase construction

	 */

	static CGlxContainerListBinding* NewLC( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

		const CMPXCollectionPath& aPath );

	/**

	* Destructor

	*/	

	~CGlxContainerListBinding();

private:

	/**

	 * ConstructL Two phase construction

	 */

	void ConstructL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, const CMPXCollectionPath& aPath );

	// From MGlxMediaListObserver

	void HandleItemAddedL( TInt aStartIndex, TInt aEndIndex, MGlxMediaList* aList );

	void HandleItemRemovedL( TInt aStartIndex, TInt aEndIndex, MGlxMediaList* aList );

	void HandleAttributesAvailableL( TInt aItemIndex, 

	    const RArray<TMPXAttribute>& aAttributes, MGlxMediaList* aList );    

	void HandleFocusChangedL( NGlxListDefs::TFocusChangeType aType, 

        TInt aNewIndex, TInt aOldIndex, MGlxMediaList* aList );

	void HandleItemSelectedL(TInt aIndex, TBool aSelected, MGlxMediaList* aList ) ;

	void HandleMessageL( const CMPXMessage& aMessage, MGlxMediaList* aList ) ;

	void HandleMediaL( TInt aListIndex, MGlxMediaList* aList ) ;

	void HandleItemModifiedL( const RArray<TInt>& aItemIndexes, MGlxMediaList* aList );

	// From CGlxBinding

	void PopulateT( Alf::MulVisualItem& aItem, const TGlxMedia& aMedia,

								TBool aIsFocused, TInt aTextureId = KErrNotFound) const;

	/**

     * Create media list

     * @ param aMediaId media id for creating filtered media list

     */ 

	void CreateMediaListL(TGlxMediaId aMedia) const;

    /**

     * Close media list

     */ 

	void CloseMediaList();

	/**

	 * HandleFocusChanged

	 * @param aIsGained holds the focus change status

	 * @param aPath source path to the collection

	 */

    TResponse HandleFocusChanged( TBool aIsGained );

private:

	//Medialist that holds the list of tags/albums

	mutable MGlxMediaList* iContainerList;

	//Fetch context to get the attributes

	CGlxDefaultAttributeContext* iFetchContext;

	// collection path from which to fetch the attribute

	CMPXCollectionPath* iContainerPath;

	TGlxSequentialIterator iIterator;

    };

#endif //_GLXCONTAINERLISTBINDING_H_