/*

* 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 : CEikRichTextEditor based Rich Text viewer

*

*/

#ifndef CESMRRICHTEXTVIEWER_H

#define CESMRRICHTEXTVIEWER_H

#include <eikrted.h>

#include <cntitem.h>

#include <eikcmobs.h>

#include "resmrstatic.h"

class CESMRRichTextLink;

class MESMRFieldEventQueue;

// SCROLLING_MOD: List observer forward declaraion

class MESMRListObserver;

/*

 * Pure virtual link selection observer.

 */

class MESMRRichTextObserver

    {

public:

    /*

     * CESMRichTextViewer calls this function with selected link before

     * showing Contact Action Menu. If observer handles link selection it

     * should return ETrue, in which case CESMRRichTextViewer won't handle

     * it.

     */

    virtual TBool

            HandleRichTextLinkSelection(const CESMRRichTextLink* aLink ) = 0;

    };

/*

 * CEikRichTextEditor based Rich Text viewer.

 */

NONSHARABLE_CLASS( CESMRRichTextViewer ) : public CEikRichTextEditor,

    {

public:

    /*

     * Two-phase constructor.

     * 				  window owning control.

     * @return Created object

     */

    IMPORT_C static CESMRRichTextViewer* NewL(

            const CCoeControl* aParent = NULL);

    /*

     * Destructor.

     */

    IMPORT_C ~CESMRRichTextViewer( );

    // From CCoeControl

    IMPORT_C void PositionChanged( );

    IMPORT_C void FocusChanged( TDrawNow aDrawNow );

    IMPORT_C TKeyResponse OfferKeyEventL(

    		TEventCode aType );

    IMPORT_C void SetMargins( TInt sMargin );

    /*

     * Sets CEikRichTextEditor's text and searches text for emails,

     * phone numbers and urls if aSearchLinks is set to ETrue.

     *

     * @param aText text to be set for CEikRichTextEditor

     * @param aSearchLinks search emails, phone numbers and urls

     */

    IMPORT_C void SetTextL(const TDesC* aText, TBool aSearchLinks = EFalse );

    /*

     * Sets observer for link selections.

     * @param aLinkObserver pointer to observer object

     */

    IMPORT_C void SetLinkObserver(MESMRRichTextObserver* aLinkObserver);

    /*

     * Adds link to text.

     * @param aLink link to be added

     */

    IMPORT_C void AddLinkL(CESMRRichTextLink* aLink );

    /**

     * Inserts link to text.

     * @param aLink link to be added

     * @param aPosition position where link is added

     */

    IMPORT_C void InsertLinkL( CESMRRichTextLink* aLink, TInt aPosition );

    /*

     * Returns selected link, or NULL if none selected.

     */

    IMPORT_C const CESMRRichTextLink* GetSelectedLink( ) const;

    /*

     * Returns text for selected link from underlying CEikRichTextViewer.

     *

     * @param aLink link

     */

    /*

     * Returns pointer to new CContactItem constructed from aLink.

     * Function uses CESMRRichTextLink::Value to create contact

     * with CESMRRichTextLink::Type information.

     *

     * @param aLink link

     */

    IMPORT_C CContactItem* CreateContactItemL( const CESMRRichTextLink& aLink );

    /*

    * Method for cesmrviewerdescriptionfield to set the list observer

    *

    * @param aObserver observer that should be notified

    */

    IMPORT_C void SetListObserver( MESMRListObserver* aObserver );

    /**

     * Returns height of one row.

     *

     * @return row's height

     */

    IMPORT_C TInt RowHeight();

    /**

     * Returns text line count.

     *

     * @return line count

     */

    IMPORT_C TInt LineCount();

    /**

     * focused row starting from one.

     * @return row's height

     */

    IMPORT_C TInt CurrentLineNumber();

    /**

     * Enables and disables action menu

     * @param aStatus Enables or disables action menu

     */

    IMPORT_C void SetActionMenuStatus( TBool aStatus );

    /**

     * action menu to the clipboard

     */

    IMPORT_C void CopyCurrentLinkToClipBoardL() const;

    /**

     * Needed for richtextviewer fields when they lose focus.

     */

    IMPORT_C void ResetActionMenuL() const;

    /**

     * Sets event queue for field. Observer can be used

     * for triggering commands and notifying events.

     * @param aEventObserver the event observer

     */

    IMPORT_C void SetEventQueue( MESMRFieldEventQueue* aEventQueue );

    /**

     * Selects current link.

     * @return ETrue if link selected

     */

    IMPORT_C TBool LinkSelectedL();

protected: // From MEikCommandObserver

    /**

     * Process commands from contact menu handler.

     */

    void ProcessCommandL( TInt aCommandId );

protected: // From CEikEdwin

    /**

     * Sets the control as ready to be drawn.

     */

    void ActivateL();

private:

    /*

     * Private constuctor.

     */

    CESMRRichTextViewer( );

    /*

     * Two-phase constructor.

     * 				  is constucted as window owning control.

     */

    void ConstructL(const CCoeControl* aParent );

    /*

     * Highlights link in CEikRichTextEditor.

     *

     * @param aLink link to be highlighted

     */

    /*

     * Private internal function which searches for emails,

     * phone numbers and urls from given text using CFindItemEngine.

     *

     * @param aText text which is shown in CEikRichTextEditor

     */

    void SearchLinksL(const TDesC& aText );

    TInt FindTextLinkBetweenNextScrollArea(

    		TCursorPosition::TMovementType aDirection);

    TInt ValidLinkForFocusing(	TInt aIndex,

                                TCursorPosition::TMovementType aDirection,

                                TInt aStartRow,

                                TInt aEndRow);

    void SetValueL( const CESMRRichTextLink& aLink );

private: // Data

    RPointerArray<CESMRRichTextLink> iLinkList;

    /// Ref:

    MESMRRichTextObserver* iLinkObserver;

    /// Own:

    RESMRStatic iESMRStatic;

    /// Ref:

    MESMRListObserver* iObserver;

    /// Own:

    TInt iApproximatelyRowHeight;

    /// Ref: pointer to font

    const CFont* iFont;

    /// Ref: Contact Menu handler

    CESMRContactMenuHandler* iCntMenuHdlr;

    /// Ref: Pointer to event queue

    MESMRFieldEventQueue* iEventQueue;

    /// Own:

    };

#endif /*CESMRRICHTEXTVIEWER_H*/