// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

#ifndef __FRMTLAY_H__

#define __FRMTLAY_H__

#include <e32std.h>

#include <e32base.h>

#include <gdi.h>

#include <txtfrmat.h>

#include <txtetext.h>

#include <frmlaydt.h>

#include <frmparam.h>

#include <frmvis.h>

#include <tagma.h>

class CWindowGc;

class MLayDoc;

class TLayDocTextSource;

class TCursorPosition;

/**

This interface class defines an interface for clients of Form to provided 

implementations of customisation interfaces relating to the source text

document as requried by the internals of Form and Tagma. Its use by

Form clients is optional.

Derived objects of this interface are registered with the CTextLayout 

API and are called from the TLayDocTextSource class at present.

@publishedPartner

@released

@see MTmInlineTextSource

*/

class MFormCustomInterfaceProvider

    {

    public:

	/**

	Form uses this method to request an interface implmentation for the

	specified interface Uid. See class description for interfaces covered

	by this API.

	@param aInterfaceId

		The unique identifier for the interface wanted by Form.

	@return 

		Ptr to interface instance or 0 if not supported by client

	*/

	virtual TAny* GetExtendedInterface(const TUid& aInterfaceId) = 0;

    };

/** Parameter used to control which part of a line (top, baseline or bottom) 

should be scrolled to a certain vertical position in a view rectangle. Used 

as a parameter in functions like CTextView::HandleGlobalChangeL() and 

CTextLayout::SetViewL(). The selected part of the line is called the hotspot.

@publishedAll

@released

*/

class TViewYPosQualifier

	{

friend class CTextLayout;

friend class CTextView;

public:

	/** Which part of a line (top, baseline or bottom) should appear at a

	vertical pixel position. */

	enum TPartOfLine

		{

		/** The top pixel is placed at the specified vertical point. */

		EFViewTopOfLine = 1,

		/** The baseline is placed at the specified vertical point. */

		EFViewBaseLine = 0,

		/** The bottom pixel is placed at the specified vertical point. */

		EFViewBottomOfLine = 2	

		};

	/** Whether the top line in the view should be fully visible. */

	enum TFullyVisible

		{

		/** Force a partially visible top line to be fully visible. */

		EFViewForceLineFullyVisible = ETrue,

		/** Do not force a partially visible top line to be fully visible. */

		EFViewDontForceLineFullyVisible = EFalse

		};

public:

	inline TViewYPosQualifier();

	IMPORT_C void SetHotSpot(TPartOfLine aHotSpot);

	IMPORT_C void SetFillScreen(TBool aFillScreen = ETrue);

	IMPORT_C void SetMakeLineFullyVisible(TFullyVisible aMakeLineFullyVisible = EFViewForceLineFullyVisible);

private:

	TPartOfLine iHotSpot;

	TBool iFillScreen;

	TFullyVisible iFullyVisible;

	};

/** 

A structure used to return the results of a reformatting operation.

@see CTextLayout::HandleBlockChangeL()

@publishedAll

@released

*/

class TViewRectChanges

	{

public:

	inline TViewRectChanges();

public:

	/** The vertical coordinate of the top of the first line of reformatted 

	text. */

	TInt iFormattedFrom;

	/** The vertical coordinate of the bottom of the last line of reformatted 

	text. */

	TInt iFormattedTo;

	/** The number of pixels by which text above the reformatted or edited 

	block has scrolled (positive values mean the text moved down). */

	TInt iScrollAtTop;

	/** The number of pixels by which text below the reformatted or edited 

	block has scrolled (positive values mean the text moved down). */

	TInt iScrollAtBottom;

	};

/** 

The cursor or cursor selection within a document.

If the cursor and anchor position differ, the selection covers the text from

the lower to the higher position, not including the character after the higher

position. If the selection is changed (by shift plus arrow keys in many UIs)

the cursor position changes and the anchor remains the same. 

@publishedAll

@released

*/

class TCursorSelection

	{

public:

	inline TCursorSelection();

	inline TCursorSelection(TInt aCursorPos,TInt aAnchorPos);

	inline void SetSelection(TInt aCursorPos,TInt aAnchorPos);

	inline TInt LowerPos() const;

	inline TInt HigherPos() const;

	inline TInt Length() const;

public:

	/** The cursor position. */

	TInt iCursorPos;

	/** The anchor position. */

	TInt iAnchorPos;

	};

/** 

Parameters used by functions that draw text.

An object of this class is passed to CTextLayout::DrawL() and to

InvertRangeL(). The draw context includes the view rectangle, the graphics

context, the background colour and the margin widths.

You only need to use this class directly when you are using a CTextLayout

object which is not owned by a CTextView object.

@publishedAll

@released

*/

class TDrawTextLayoutContext

	{

private:

	enum TDrawMode

		{

		EFDrawText=0x001,

		EFDrawGraphics=0x002,

		EFUseClippingRect=0x004,

		EFUseWindowGc=0x008,

		EFUseGcClear=0x020,

		EFUseBackgroundColor=0x040,

		EFUseOverrideTextColor=0x080,

		EFParagraphFillTextOnly=0x100,

		EFAllFlags=0xfff

		};

public:

	IMPORT_C TDrawTextLayoutContext();

	IMPORT_C void SetGc(CGraphicsContext* aGc,CGraphicsContext* aPictureGc=NULL);

	IMPORT_C void SetBitmapGc(CBitmapContext* aGc,CBitmapContext* aPictureGc=NULL);

	IMPORT_C void SetWindowGc(CWindowGc* aGc,CWindowGc* aPictureGc=NULL);

	IMPORT_C void SetDrawToEveryPixel(TBool aDrawToEveryPixel);

	IMPORT_C void SetTextColorOverride(const TRgb *aOverrideColor);

	IMPORT_C void SetDrawTextOnly();

	IMPORT_C void SetDrawGraphicsOnly();

	IMPORT_C void SetDrawTextAndGraphics();

	IMPORT_C void SetClipping(TBool aClipping);

	// deprecated 7.0 

	IMPORT_C void SetParagraphFillTextOnly(TBool aFillTextOnly);

//Enquiry functions

	IMPORT_C const TRgb* TextOverrideColor() const;

	IMPORT_C CGraphicsContext* PrimaryGc() const;

	IMPORT_C CGraphicsContext* PictureGc() const;

	IMPORT_C TBool UseClippingRect() const;

	IMPORT_C TBool UseGcClear() const;

	IMPORT_C TBool DrawText() const;

	IMPORT_C TBool DrawGraphics() const;

	IMPORT_C TBool UseBackgroundColor() const;

	// deprecated 7.0

	IMPORT_C TBool ParagraphFillTextOnly() const;

//Physical dimensions

	IMPORT_C TRect TextArea() const;

	IMPORT_C TInt DisplayHeight() const;

	IMPORT_C TPoint TopLeftTextArea() const;

	IMPORT_C TRect TotalMargin() const;

	IMPORT_C TRect LabelMargin() const;

	IMPORT_C TBool IsLabelMargin() const;

	IMPORT_C TRect GutterMargin() const;

	IMPORT_C TBool IsGutterMargin() const;

	IMPORT_C TPoint TopLeftText() const;

	IMPORT_C void WindowToText(TPoint& aWinPos) const;

	IMPORT_C void WindowToText(TRect& aRect) const;

	IMPORT_C void TextToWindow(TPoint& aTextAreaPos) const;

	IMPORT_C void TextToWindow(TRect& aRect) const;

	TBool UseWindowGc() const;

	void SetDrawMode(TUint aDrawMode);

	TUint DrawMode() const;

public:

	/** The view rectangle (specified in window coordinates). This is used to 

	set the	area in which text can be drawn. Text can only be drawn within the 

	intersection between the text area and the aDrawRect parameter passed to 

	CTextLayout::DrawL() or InvertRangeL(). */

	TRect iViewRect;

	/** The label margin width. By default zero. Must have the same value as 

	the label margin width as set in the text layout object. */

	TInt iLabelMarginWidth;

	/** The gutter margin width (also known as the line cursor margin width). 

	By default	zero. */

	TInt iGutterMarginWidth;

	/** The horizontal offset between window coordinates and text layout 

	coordinates. */

	TInt iTextStartX;

	/** The background colour for the view rectangle. The background colour is 

	used to fill the parts of the view rectangle in which text cannot appear, 

	for example, below the last line of the document and in the label, line 

	cursor and left	text margins. */

	TLogicalRgb iBackgroundColor;

private:

	CGraphicsContext* iGc;

	CGraphicsContext* iPictureGc;

	TLogicalRgb iOverrideTextColor;

	TUint iDrawMode;

	};

/** 

An abstract class which specifies the protocol for customising the way text

and its background are drawn.

Common uses for this are to implement custom highlighting or to draw a 

background bitmap. You must create an object of a class derived from this class 

and call CTextLayout::SetCustomDraw(), passing a pointer to the object. All of 

these functions have default implementations. Your class can override any of the

virtual functions listed below.

@publishedAll

@released

*/

class MFormCustomDraw

	{

	public:

	class TParam

	/**

	Parameters used by several custom draw functions

	@publishedAll

	@released

	*/

			{

		public:

		TParam(CGraphicsContext& aGc,MGraphicsDeviceMap& aMap,const TPoint& aTextLayoutTopLeft,const TRect& aDrawRect):

			iGc(aGc), iMap(aMap), iTextLayoutTopLeft(aTextLayoutTopLeft), iDrawRect(aDrawRect) { }

		CGraphicsContext& iGc;

		MGraphicsDeviceMap& iMap;

		const TPoint& iTextLayoutTopLeft;

		const TRect& iDrawRect;

		};

	class TLineInfo

	/** 

	Contains the line metrics.

	@publishedAll

	@released

	*/

			{

		public:

		TLineInfo(const TRect& aOuterRect,const TRect& aInnerRect,TInt aBaseline):

			iOuterRect(aOuterRect), iInnerRect(aInnerRect), iBaseline(aBaseline) { }

		const TRect& iOuterRect;

		const TRect& iInnerRect;

		TInt iBaseline;

		};

	IMPORT_C virtual void DrawBackground(const TParam& aParam,const TRgb& aBackground,TRect& aDrawn) const;

	IMPORT_C virtual void DrawLineGraphics(const TParam& aParam,const TLineInfo& aLineInfo) const;

	IMPORT_C virtual void DrawText(const TParam& aParam,const TLineInfo& aLineInfo,const TCharFormat& aFormat,

								   const TDesC& aText,const TPoint& aTextOrigin,TInt aExtraPixels) const;

	IMPORT_C virtual TRgb SystemColor(TUint aColorIndex,TRgb aDefaultColor) const;

	IMPORT_C virtual void MFormCustomDraw_Reserved_1();

	IMPORT_C virtual void MFormCustomDraw_Reserved_2();

	};

/** 

An interface class that can be derived from to implement custom line breaking.

Custom line breaking allows the Text Views line wrapping algorithm to break

lines in any way. For instance, it may be used to avoid the jagged white space

at the right edge of text windows caused by normal line wrapping on a small

screen.

All of these functions have a default implementation. To change the default

behaviour, a pointer to an object that overrides any or all of the functions

in the interface needs to be passed to the function CTextLayout::SetCustomWrap().

@since 6.2

@see CTextLayout::SetCustomWrap()

@publishedAll

@released

*/

class MFormCustomWrap

	{

public:

	IMPORT_C virtual TUint LineBreakClass(TUint aCode,TUint& aRangeStart,TUint& aRangeEnd) const;

	IMPORT_C virtual TBool LineBreakPossible(TUint aPrevClass,TUint aNextClass,TBool aHaveSpaces) const;

	IMPORT_C virtual TBool GetLineBreakInContext(const TDesC& aText,TInt aMinBreakPos,TInt aMaxBreakPos,

												 TBool aForwards,TInt& aBreakPos) const;

	IMPORT_C virtual TBool IsHangingCharacter(TUint aChar) const;

private:

	IMPORT_C virtual void MFormCustomWrap_Reserved_1();

	IMPORT_C virtual void MFormCustomWrap_Reserved_2();	

	};

/** 

Mixin class used to customize visible appearance of invisible characters 

such as a paragraph mark or a tab.

@see CTextView::SetCustomInvisibleCharacterRemapper()

@publishedAll

@released

*/

class MFormCustomInvisibleCharacterRemapper

	{

public:

	IMPORT_C static TUint DefaultMapping(TUint aChar, const TNonPrintingCharVisibility aNonPrintingCharVisibility, const TLayDocTextSource& aLayDoc);

	/** 

	Allows custom remapping of invisible characters.

	Called by TLayDocTextSource::Map() if it has been created and registered 

	with TLayDocTextSource using CTextLayout::SetInvisibleCharacterRemapper().

	Unless there is a specific reason for doing otherwise it is recommended 

	that where this function has not remapped a given character it should 

	pass it to DefaultMapping() to let it try.

	@param aChar

		Invisible character to be remapped

	@param aDesiredVisibilities

		Current state of flags showing visibility of invisible characters

	@param aLayDoc

		Const ref to the calling CLayDocTextSource

	@return

		The replacement character if remapping has taken place, else return original character

	*/

	virtual TUint Remap(TUint aChar, const TNonPrintingCharVisibility aNonPrintingCharVisibility, const TLayDocTextSource& aLayDoc) = 0;

	};

/**

@internalTechnology

Internal to Symbian

*/

NONSHARABLE_CLASS(TLayDocTextSource) : public MTmSource, public MFormLabelApi, public MTmTextDrawExt

	{

	public:

	enum

		{

		EDefaultFontHeightIncreaseFactor = 7,

		EDefaultMinimumLineDescent = 3

		};

	TLayDocTextSource();

	// overrides for MTmSource pure virtual functions

	MGraphicsDeviceMap& FormatDevice() const;

	MGraphicsDeviceMap& InterpretDevice() const;

	TInt DocumentLength() const;

	void GetText(TInt aPos,TPtrC& aText,TTmCharFormat& aFormat) const;

	void GetParagraphFormatL(TInt aPos,RTmParFormat& aFormat) const;

	TInt ParagraphStart(TInt aPos) const;

	// overrides for other MTmSource virtual functions

	TRgb SystemColor(TUint aColorIndex,TRgb aDefaultColor) const;

	CPicture* PictureL(TInt aPos) const;

	TInt GetPictureSizeInTwipsL(TInt aPos,TSize& aSize) const;

	TBool LabelModeSelect(TLabelType aType, TInt aPos);

	void LabelModeCancel();

	void LabelMetrics(TLabelType aType, TSize& aLabelSize, TInt& aMarginSize) const;

	TUint Map(TUint aChar) const;

	void SetLineHeight(const TLineHeightParam& aParam,TInt& aAscent,TInt& aDescent) const;

	TBool PageBreakInRange(TInt aStartPos,TInt aEndPos) const;

	void DrawBackground(CGraphicsContext& aGc,const TPoint& aTextLayoutTopLeft,const TRect& aRect,

						const TLogicalRgb& aBackground,TRect& aRectDrawn) const;

	void DrawLineGraphics(CGraphicsContext& aGc,const TPoint& aTextLayoutTopLeft,const TRect& aRect,

						  const TTmLineInfo& aLineInfo) const;

	void DrawText(CGraphicsContext& aGc,const TPoint& aTextLayoutTopLeft,const TRect& aRect,

				  const TTmLineInfo& aLineInfo,const TTmCharFormat& aFormat,

				  const TDesC& aText,const TPoint& aTextOrigin,TInt aExtraPixels) const;

	virtual void DrawPicture(CGraphicsContext& aGc,

							 const TPoint& aTextLayoutTopLeft, const TRect& aRect,

							 MGraphicsDeviceMap& aDevice, const CPicture& aPicture) const;

	// overrides for the MTmSource virtual functions which implements the MFormCustomWrap

	// if iCustomWrap is set. 

	TBool LineBreakPossible(TUint aPrevClass,TUint aNextClass,TBool aHaveSpaces) const;

	TUint LineBreakClass(TUint aCode,TUint& aRangeStart,TUint& aRangeEnd) const;

	TBool GetLineBreakInContext(const TDesC& aText,TInt aMinBreakPos,TInt aMaxBreakPos,

												 TBool aForwards,TInt& aBreakPos) const;

	TBool IsHangingCharacter(TUint aChar) const;

	// other functions

	TBool CanMap() const;

	TAny* GetExtendedInterface(const TUid& aInterfaceId);

	//MTmTextDrawExt implementations

	virtual void DrawLine(CGraphicsContext& aGc, const TPoint& aPt1, const TPoint& aPt2) const;

	virtual void DrawText(CGraphicsContext& aGc, const TDesC& aText, const TPoint& aPt) const;

	virtual void DrawRect(CGraphicsContext& aGc, const TRect& aRc) const;

	//Set/reset opaque flag of aGc graphics context

	void SetOpaque(CGraphicsContext& aGc) const;

	void ResetOpaque(CGraphicsContext& aGc) const;

	// flags

	enum

		{

		EWrap = 1,

		ETruncateWithEllipsis = 2,

		EUseLabelsDevice = 4

		};

	MLayDoc* iLayDoc;

	TUint iFlags;								// wrap, truncate, etc.

	TInt iWidth;								// wrapping width

	TChar iEllipsis;							// ellipsis character (or none if 0xFFFF) used if truncating

	TInt iLabelsWidth;

	TInt iLabelsGutter;

	CLayoutData::TFormatMode iFormatMode;

	MGraphicsDeviceMap* iImageDevice;			// device map used for drawing text

	MGraphicsDeviceMap* iLabelsDevice;			// device map used for labels

	MGraphicsDeviceMap* iFormatDevice;			// device map used for formatting

	TInt iFontHeightIncreaseFactor;				// percentage automatically added to font heights

	TInt iMinimumLineDescent;					// minimum line descent in pixels

	TNonPrintingCharVisibility iNonPrintingCharVisibility;

	const MFormParam* iFormParam;				// if non-null, points to the object that supplies system colours

	const MFormCustomDraw* iCustomDraw;			// if non-null, points to custom drawing routines

	const MFormCustomWrap* iCustomWrap;			// if non-null, points to custom wrapping routines 

    /** Optional object able to provide a concrete customisation object for use 

	    internally by Form. */

	MFormCustomInterfaceProvider* iInterfaceProvider;

	TBool iDrawOpaque;						// Opaque drawing active if the flag is ETrue

	TInt iExcessHeightRequired;				// delta required to position the baseline so there is enough

											// space for the highset glyph in pixels.  

	MFormCustomInvisibleCharacterRemapper* iInvisibleCharacterRemapper;	// Used to customize the remapping of 

																		// invisible characters to visible characters

	};

/** 

Text layout.

CTextLayout is the lowest-level text formatting class in the Text Views API. It

obtains text and formatting attributes via the MLayDoc interface class and

formats the text to a certain width.