/*

* Copyright (c) 2007-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:  ESMR Description field for CESMRListComponent

 *

*/

#ifndef CESMRDESCRIPTIONFIELD_H

#define CESMRDESCRIPTIONFIELD_H

#include <eikedwob.h>

#include <frmtlay.h>

#include "cesmrfield.h"

class CESMREditor;

class CCalEntry;

class CAknsFrameBackgroundControlContext;

class CESMRRichTextLink;

class CESMRFeatureSettings;

/**

 * This class is a custom field control that shows the description of calendar events

 */

NONSHARABLE_CLASS( CESMRDescriptionField ): public CESMRField, 

											public MEikEdwinSizeObserver,

											public MEikEdwinObserver

    {

public:

    /**

     * Creates new CESMRDescriptionField object. Ownership

     * is transferred to caller.

     * @return Pointer to created object,

     */

    static CESMRDescriptionField* NewL();

    /**

     * C++ Destructor.

     */

    ~CESMRDescriptionField();

public: // From CESMRField

    void InitializeL();

    void InternalizeL( MESMRCalEntry& aEntry );

    void ExternalizeL( MESMRCalEntry& aEntry );

    void SetOutlineFocusL( TBool aFocus );

    TInt ExpandedHeight() const;

    TInt GetVerticalFocusPosition();

    void GetMinimumVisibleVerticalArea(TInt& aUpper, TInt& aLower);

    void ListObserverSet();

    void ExecuteGenericCommandL( TInt aCommand );

public: // From CCoeControl

    TKeyResponse OfferKeyEventL(const TKeyEvent& aEvent, TEventCode aType);

    void ActivateL();

    void PositionChanged();

public: // From MEikEdwinSizeObserver

    TBool HandleEdwinSizeEventL( CEikEdwin* aEdwin, TEdwinSizeEvent aType, TSize aSize );

public: // From MEikEdwinObserver

	void HandleEdwinEventL(CEikEdwin* aEdwin,TEdwinEvent aEventType);

private:

    /**

     * Constructor.

     */

    CESMRDescriptionField();

    /**

     * Second phase constructor.

     */

    void ConstructL();

    /**

     * Converts raw URL text to a link in description editor field

     *  

     * @param aEntry Calendar entry from which the description text is received

     */ 

    void StoreLinkL( MESMRCalEntry& aEntry );

    /**

     * Adds link to the beginning of text from editor field

     * 

     * @param abuf initial description text buffer before addition

     * 

     * @return The description text buffer with link added

     */ 

    HBufC* AddLinkToTextL( const TDesC& aBuf );

    /**

     * Gets feature settings

     */

    CESMRFeatureSettings& FeaturesL();

private:

    /**

     * Not owned. Description editor object.

     */

    CESMREditor* iDescription;

    /**

     * Field size.

     */

    TSize iSize;

    /**

     * Background control context

     */

    MAknsControlContext* iBackground;

    /**

     * Actual background for the editor

     */

    CAknsFrameBackgroundControlContext* iFrameBgContext;

    /**

     * Own: Location Url link

     */ 

    CESMRRichTextLink* iLocationLink;

    /**

     * Own: Feature settings.

     */

    CESMRFeatureSettings* iFeatures;

    };

#endif  // CESMRDESCRIPTIONFIELD_H