/*
* 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:   Anchor layout definition.
*
*/



#ifndef C_ALFLCTANCHORLAYOUT_H
#define C_ALFLCTANCHORLAYOUT_H

#include <alf/alfanchorlayout.h> 

class TAknLayoutHierarchyComponentHandle;

/**
 *  LCT Anchor layout
 * 
 * This is a specialised anchor layout, which is aware of the 
 * avkon LCT layout system. It provides additional APIs
 * that allow anchors to be set by referring to LCT layout 
 * components from the Layout Specifcations.
 *
 *  @lib alfclient.lib
 *  @since S60 v3.2
 */
class CAlfLCTAnchorLayout : public CAlfAnchorLayout
    {

public:

    /**
     * Two-phased constructor, which attach new object into the control.
     * @param aOwnerControl Control that owns this new obejct.
     * @param aParentLayout If given, the new object is set as child.
     */
    IMPORT_C static CAlfLCTAnchorLayout* AddNewL(CAlfControl& aOwnerControl,
                                              CAlfLayout* aParentLayout = 0);

    /**
     * Constructor.
     */
    IMPORT_C CAlfLCTAnchorLayout();

    /**
     * Second-phase constructor.
     */
    IMPORT_C void ConstructL(CAlfControl& aOwner);

    /**
     * Destructor.
     */
    IMPORT_C ~CAlfLCTAnchorLayout();

    /**
     * Defines both anchors for a child.. An anchor is a point within the layout control
     * that a child control's corner may be attached to. The use of anchors
     * allows for the neat layout of visuals within the layout control.
     *     
     * @param aOrdinal Ordinal of the child that this anchor applies to.
     * @param aComponentHandle reference to the layout data that corresponds to 
     *                                                  the visual that is anchored at this ordinal position.
     * @ param aOffset timed point, note that the position of the timed point will be ignored.
     */
    IMPORT_C void SetAnchors(
        TInt aOrdinal,
        TAknLayoutHierarchyComponentHandle& aComponentHandle,
        const TAlfTimedPoint& aOffset);

    /**
     * From CAlfVisual
     * @see CAlfVisual
     */
    IMPORT_C void RemoveAndDestroyAllD();
    IMPORT_C void UpdateChildrenLayout(TInt aTransitionTime = 0);
    IMPORT_C CAlfVisual* FindTag(const TDesC8& aTag);
    /** 
     * From CAlfLayout
     * @see CAlfLayout
     */
    IMPORT_C TAlfXYMetric BaseUnit() const; 


protected:
    /**
     * From CAlfVisual
     * @see CAlfVisual
     */
    IMPORT_C void DoRemoveAndDestroyAllD();
    IMPORT_C void PropertyOwnerExtension(const TUid& aExtensionUid, TAny** aExtensionParams);


private:

    struct TLCTAnchorLayoutPrivateData;
    TLCTAnchorLayoutPrivateData* iLCTAnchorLayoutData;
    };



#endif // C_ALFLCTANCHORLAYOUT_H