/*
* 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: This file defines class CESMRNcsEditor.
*
*/

#ifndef CESMRNCSEDITOR_H
#define CESMRNCSEDITOR_H

#include <eikrted.h>
#include <AknUtils.h>

class CAknsBasicBackgroundControlContext;
class CNcsCustomDraw;
class CESMRLayoutManager;

/**
 *  CESMRNcsEditor is a specialised CEikRichTextEditor for 
 *  the email address lists for attendee fields.
 */
NONSHARABLE_CLASS( CESMRNcsEditor ) : public CEikRichTextEditor
    {
public:
    /** 
     * Constructor of this class
     * @param default text of the editor
     * @param aHeaderField set if editor contains a headerfield
     * @returns CESMRClsItem instance
     */
    CESMRNcsEditor( HBufC* aDefaultText );

    /**
     * C++ Virtual Destructor.
     */
    virtual ~CESMRNcsEditor();

public: // new functions
    /**
     * Get the size and position rectangle of the editor
     * @param aLineRect rectangle of the editor
     */
    void GetLineRectL( TRect& aLineRect ) const;

    /**
     * Get the number of scrollable lines of the rich text editor
     * @return number of scrollable lines
     */
    virtual TInt ScrollableLines() const;

    /**
     * Get the current line number of the selection
     * @return current selected line number 
     */
    virtual TInt CursorLineNumber() const;

    /**
     * Get the number of lines in the editor
     * @return number of lines in the editor
     */
    virtual TInt LineCount() const;

    /**
     * Get the current position in the editor line
     * @return position in the current line of the editor
     */
    virtual TInt CursorPositionL() const;

    /**
     * Get the descriptor content of the editor label
     * @return descriptor of the label
     */
    virtual const TDesC& GetLabelText() const;

    /**
     * Set the maximum length for the label
     * @param aSize maximum length for the label
     */
    void SetMaximumLabelLength( TSize aSize );

    /**
     * Initialise/reset the rich text editor
     */
    void SetupEditorL();

    /**
     * Update editor content
     */
    void UpdateEditorL();

    /**
     * Update editor position
     */
    void PositionChanged();

    /**
     * Get the height of the text in the editor
     * @return height of the text in the editor
     */
    TInt TextHeight() const;

    /**
     * Get the height of the single line of text in the editor
     * @return height of the single line of text in the editor
     */
    TInt GetLineHeightL() const;

    /**
     * Get the number of characters in the editor
     * @return number of characters in the editor
     */
    TInt GetNumChars() const;

    /**
      * Get the length of the editor document
      * @return length of the editor document
      */
    TInt DocumentLength() const;

    /**
      * Get the number of pixels above the current editor line
      * @return number of pixels above the current editor line
      */
    TInt PixelsAboveBand() const;

    /**
      * Change the number of pixels above the current editor line
      * @param aPixels set the  number of pixels above the current editor line
      */
    TInt ChangeBandTopL(TInt aPixels);

    /**
      * Set the color of the text in the editor
      * @param aColor color of the text in the editor
      */
    void SetTextColorL( TLogicalRgb aColor );

    /**
      * check if the editor has default text available
      * @param ETrue if editor has default text available
      */
    TBool HasDefaultText();

    /**
      * Get length of text after trim
      * return length of text after trim
      */
    TInt TrimmedTextLengthL();

    /**
      * Set the font of the editor
      * @param aFont font of the editor
      * @param aLayout pointer to layout manager to get the font and sizes
      */
    void SetFontL( const CFont* aFont, CESMRLayoutManager* aLayout );
    
#ifdef _DEBUG
    void DebugDump();
#endif

public: // from CoeControl
    TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, TEventCode aType );
    void SetTextL( const TDesC* aDes );
    void SetRect( const TRect& aRect );

protected: // from CEikEdwin
    virtual void HandleResourceChange( TInt aType );

protected: // from MEditObserver
    virtual void EditObserver( TInt aStart, TInt aExtent );

private: // Implementation
    void UpdateColors();
    void UpdateGraphics();
    void DoUpdateGraphicsL();

private: // data
    TInt iPreviousFontHeight;
    TInt32 iPreviousLineSpacingInTwips;
    HBufC* iDefaultText;//not own
    TBool iHasDefaultText;
    TRgb iTextColor;

    // background control context. Owned.
    CAknsBasicBackgroundControlContext* iBgContext;
    };


#endif