/*

* 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:    Binding Set Factory ;Base for all Binding Set

*

*/

#ifndef _GLXBINDINGSETFACTORY_H_

#define _GLXBINDINGSETFACTORY_H_

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

#include <mpxattribute.h>           // MPX Attribute data type class

#include <mul/imulwidget.h>

#include <mul/mulvisualitem.h>          // Client need to use this class to add data in data model

class CGlxBindingSet;               // basically holds the bindings required to populate the visual item.

class CMPXCollectionPath;           // Encapsulates a 'bookmark' to a specific collection entry

class MGlxBindingObserver;          // Observer for Bindings

class MGlxBoundCommand;             // Handles user commands

class TMPXAttribute;                // TMPXAttribute data type class.

class CGlxMulIconProvider;          // Icon details  

class TGlxMulBindingSetFactory 

    {

public:

	/**

	* CreateBindingSetL creates instance of Binding set 

	* @param aObserver Binding observer

	*/

	CGlxBindingSet* CreateBindingSetL( MGlxBindingObserver& aObserver ) const; 

protected: 

	/**

	 * Constructor

	 */

	IMPORT_C TGlxMulBindingSetFactory();

	/**

	 * Destructor

	 */

	IMPORT_C virtual ~TGlxMulBindingSetFactory();

	/**

	 * Creates String binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 * @param aString MPX constant string

	 */

	IMPORT_C void AddStringBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

	TInt aStringId ) const;

	/**

	 * Creates MPX Attribute binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 * @param aAttribute MPX attribute

	 */

	IMPORT_C void AddMpxAttributeBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

	const TMPXAttribute& aAttribute, TInt aFormatStringId = NULL ) const;

	/**

	 * Creates Thumbnail binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 */

	IMPORT_C void AddThumbnailBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

	const TSize& aSize ) const;

		/**

	 * Creates FullScreenThumbnail binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 */

	IMPORT_C void AddFullScreenThumbnailBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/ )const;

	/**

	 * Creates icon binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 */

	IMPORT_C void AddIconBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

        const CGlxMulIconProvider* aMulIcon, const TSize& aSize )const;

	/**

	 * Creates Container list binding and adds it to binding set	

	 * @param aMulTag Template attribute of widget

	 * @param aPath MPX collection path which will be used to fetch the attributes for media item

	 */

	IMPORT_C void AddContainerListBindingL( const Alf::mulvisualitem::TVisualAttribute& aMulTag /*const char* const aMulTag*/, 

	const CMPXCollectionPath& aPath ) const;

	/**

	 * Creates command binding and adds it to binding set	

	 * @param aCommand command associated with option menu item/items

	 */

	/** takes ownership of aCommand */

	IMPORT_C void AddCommandBindingL( MGlxBoundCommand* aCommand ) const; 

	/** @param aTemplateWhenFocused template to be used when item is focused.

	*         if not defined, uses aTemplate also for the focused item */

	IMPORT_C void AddTemplateBindingL(

	    Alf::mulwidget::TLogicalTemplate aTemplate, 

		Alf::mulwidget::TLogicalTemplate aTemplateWhenFocused = Alf::mulwidget::KTemplateUnknown) const;

	/**

	 * Creates preview thumbnail binding and adds it to binding set

	 */

	IMPORT_C void AddPreviewThumbnailBindingL() const;

private:

	virtual void AddBindingsL() const = 0;

private: 

	mutable CGlxBindingSet* iBindingSet; // not own

    };

#endif // _GLXBINDINGSETFACTORY_H_