/*
* 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_