/*

* Copyright (c) 2008 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:  interface for layout policy

*

*/

#ifndef I_ALFLCTANCHORLAYOUTMANAGER

#define I_ALFLCTANCHORLAYOUTMANAGER

#include <alf/ialfinterfacebase.h>

#include <alf/alftypes.h>

namespace osncore

    {

class UString;

    }

class CAlfControl;

class TAknLayoutHierarchyComponentHandle;

namespace Alf

    {

class CAlfWidgetControl;

namespace ialflctanchorlayoutpolicy

    {

     static const IfId Ident =

        {

        0, "lctanchorlayoutpolicy"

        };

    }

using namespace osncore;    

using Alf::CAlfWidgetControl;

/**

 * The interface for grid layout policy

 *

 * Provides grid specific layout APIs

 * 

 * @code

 * // Create layout manager interface.

 * IAlfLayoutManager* layoutManager = IAlfInterfaceBase::makeInterface<IAlfLayoutManager>(control);

 *

 * // See if layout policy is supported in the given layout manager.

 * IAlfLCTAnchorLayoutPolicy* layoutPolicy = IAlfInterfaceBase::makeInterface<IAlfLCTAnchorLayoutPolicy>(layoutManager);

 *

 * if(layoutPolicy != 0)

 *     {

 *     int rows = layoutPolicy->Attach(componentHandle);

 *     }

 * @endcode

 *

 * @lib alfwidgetmodel.lib

 * @since S60 ?S60_version

 */

class IAlfLCTAnchorLayoutPolicy : public IAlfInterfaceBase

    {

public:

    static inline const IfId& type()

        {       

        return ialflctanchorlayoutpolicy::Ident;

        }

    virtual inline ~IAlfLCTAnchorLayoutPolicy() {}

   /**

    * attach the anchors needed for a child visual, according to the layout data 

    * corresponding to the component handle.

    *

    * @note this should can be used for layout text components, but also use IAlfLCTTextLayoutPolicy 

    * with the contained text visual to set the text style and alignment

    *

    * @param aOrdinal the child visual index

    * @param aComponentHandle the layout data to use

    */ 

    virtual void Attach (int aOrdinal, const UString& aLCTString, int aVarietyIndex) = 0;

// from base class IAlfInterfaceBase

    /**

     * Interface getter. 

     * @see IAlfInterfaceBase::MakeInterface

     *

     * @param aType The type id of the queried interface.

     * @return The queried interface, or NULL if the interface is not

     *         supported or available.

     */    

    virtual IAlfInterfaceBase* makeInterface( const IfId& aType ) = 0;

    };

    } // namespace Alf

#endif // I_ALFLCTANCHORLAYOUTMANAGER