/*

* Copyright (c) 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:  

*

*/

#ifndef MMLCTUTILS_H

#define MMLCTUTILS_H

// INCLUDES

#include <e32std.h>

#include <e32base.h>

#include <aknlayoutscalable_uiaccel.cdl.h>

#include <aknlayoutscalable_avkon.cdl.h>

#include <AknDef.hrh>

#include "mmtemplatelibrary.h"

// CLASS DECLARATION

/**

 *  Utilities for LCT scalable layout support in Multimedia Menu.

 * 

 *  @code

 *  @endcode

 *  @lib mmwidgets

 *  @since S60 v3.0

 *  @ingroup group_mmwidgets

 */

class MmLCTUtils

	{

public:

	/**

	 * Gets the window component layout for the given layout name and variety.

	 * 

	 * @since S60 v3.0

	 * @param aLayout Name of the layout.

	 * @param aVariety Variety for the layout.

	 * @return Window component layout.

	 */

	static TAknWindowComponentLayout ItemLayout (const TDesC8& aLayout,

			TInt aVariety);

    /**

     * Gets the text component layout for the given layout name and variety.

     * 

     * @since S60 v3.0

     * @param aLayout Name of the layout.

     * @param aVariety Variety for the layout.

     * @return Text component layout.

     */

	static TAknTextComponentLayout

			TextLayout (const TDesC8& aLayout, TInt aVariety);

    /**

     * Gets the Window component layout for the given layout name and variety. Used for setting up graphical subcells.

     * 

     * @since S60 v3.0

     * @param aLayout Name of the layout.

     * @param aVariety Variety for the layout.

     * @return Window component layout.

     */

	static TAknWindowComponentLayout GraphicLayout (const TDesC8& aLayout,

			TInt aVariety);

    /**

     * Sets up template data for text subcell.

     * 

     * @since S60 v3.0

     * @param aItemSize Size of the parent item.

     * @param aSubCellTemplate Template data to be set.

     */

	static void SetupTextSubCellTemplate (TSize aItemSize,

			TTemplateChild& aSubCellTemplate);

    /**

     * Sets up template data for graphic subcell.

     * 

     * @since S60 v3.0

     * @param aItemSize Size of the parent item.

     * @param aSubCellTemplate Template data to be set.

     */

	static void SetupGraphicSubCellTemplate (TSize aItemSize,

			TTemplateChild& aSubCellTemplate);

    /**

     * Calculates the item size using LCT.

     * 

     * @since S60 v3.0

     * @param aLCTTemplate Name of the layout.

     * @param aVariety Variety for the layout.

     * @param aParentRect Parent rectangle.

     * @param aWindowLayout Window component layout to be set.

     * @return Size of the item calculated by LCT.

     */

	static TSize GetLCTSize (const TDesC8& aLCTTemplate, TInt aVariety,

			const TRect aParentRect, TAknWindowLineLayout& aWindowLayout );

    /**

     * Calculates the layout size using LCT.

     * 

     * @since S60 v3.0

     * @param aLCTTemplate Name of the layout template.

     * @param aVariety Variation of the layout.

     * @return Size of the layout (e.g 3x4) calculated by LCT.

     */

	static TSize GetLayoutSize( const TDesC8& aLCTTemplate, TInt aVariety );

	/**

     * Gets the structure of parameters for a given layout.

     * 

     * @since S60 v3.0

     * @param aLayout Name of the layout template.

     * @param aVariety Variation of the layout.

     * @return 

     */

	static TAknLayoutScalableParameterLimits LCTParameterLimits( const TDesC8& aLayout, TInt aVariety );

	};

#endif // MMLCTUTILS_H