--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/textrendering/texthandling/stext/TXTFRMAT.CPP	Tue Feb 02 02:02:46 2010 +0200
@@ -0,0 +1,928 @@
+/*
+* Copyright (c) 2003-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: 
+*
+*/
+
+
+#include <e32std.h>
+#include <e32base.h>
+
+#include <gdi.h>
+#include "TXTFRMAT.H"
+
+#include "TXTSTD.H"
+
+
+const TInt KParaDefaultLanguage=0;
+const TInt KParaDefaultLeftMargin=0;
+const TInt KParaDefaultRightMargin=0;
+const TInt KParaDefaultIndent=0;
+const CParaFormat::TAlignment KParaDefaultHorizAlign=CParaFormat::ELeftAlign;
+const CParaFormat::TAlignment KParaDefaultVertAlign=CParaFormat::EUnspecifiedAlign;
+const TInt KParaDefaultLineSpacing=200; // 200 twips = 10pt
+const CParaFormat::TLineSpacingControl KParaDefaultLineSpacingControl=CParaFormat::ELineSpacingAtLeastInTwips;
+const TInt KParaDefaultSpaceBefore=0;
+const TInt KParaDefaultSpaceAfter=0;
+const TBool KParaDefaultKeepTogether=EFalse;
+const TBool KParaDefaultKeepWithNext=EFalse;
+const TBool KParaDefaultStartNewPage=EFalse;
+const TBool KParaDefaultWidowOrphan=EFalse;
+const TBool KParaDefaultWrap=ETrue;
+const TInt KParaDefaultBorderMargin=0;
+const TInt KParaDefaultTabWidth=360; // 360 twips = 0.25"
+const TUint KParFormatBits = (2 << EAttTabStop) - 1;
+const TUint KCharFormatBits = (2 << (EAttFontHiddenText - EAttCharLanguage)) - 1;
+
+	
+EXPORT_C TTabStop::TTabStop():
+	iTwipsPosition(0),
+	iType(ELeftTab)
+/** The default C++ constructor constructs a TTabStop. The twips position is 
+initialised to zero and the alignment to ELeftTab. */
+ 	{
+	}
+
+EXPORT_C TTabStop::TTabStop(const TTabStop& aTabStop):
+	iTwipsPosition(aTabStop.iTwipsPosition),
+	iType(aTabStop.iType)
+	{
+	}
+
+EXPORT_C TTabStop& TTabStop::operator=(const TTabStop& aTabStop)
+/** Assigns the twips position and alignment of aTabStop to the current TTabStop.
+
+@param aTabStop The tab stop to assign to the current tab stop. 
+@return The current tab stop. */
+	{
+	iTwipsPosition=aTabStop.iTwipsPosition;
+	iType=aTabStop.iType;
+	return *this;
+	}
+
+EXPORT_C TBool TTabStop::operator==(const TTabStop& aTabStop)const
+/** Compares two tab stops for equality. To be equal, they must have the same 
+twips position and alignment.
+
+@param aTabStop The tab stop to compare with the current tab stop. 
+@return ETrue if both tab stops have the same twips position and alignment. 
+EFalse if not. */
+	{
+	if (iTwipsPosition!=aTabStop.iTwipsPosition)
+		return EFalse;
+	if (iType!=aTabStop.iType)
+		return EFalse;
+	return ETrue;
+	}
+
+EXPORT_C TParaBorder::TParaBorder():
+	iLineStyle(ENullLineStyle),
+	iThickness(0),
+	iColor(TLogicalRgb::ESystemForegroundColor),
+	iAutoColor(ETrue)
+/** The default C++ constructor constructs a TParaBorder, initializing its line 
+style to ENullLineStyle, its line thickness to zero, its colour to KRgbBlack 
+and iAutocolor to ETrue. */
+	{
+	}
+
+EXPORT_C TBool TParaBorder::operator==(const TParaBorder& aParaBorder)const
+/** Compares two paragraph border sides for equality. For two paragraph border 
+sides to be equal, all data members must be equal.
+
+@param aBorder The paragraph border to compare with the current border.
+@return ETrue if the two paragraph border sides are equal, EFalse if not. */
+	{
+	if (iLineStyle!=aParaBorder.iLineStyle)
+		return EFalse;
+	if (iThickness!=aParaBorder.iThickness)
+		return EFalse;
+	if (iColor!=aParaBorder.iColor)
+		return EFalse;
+	if (iAutoColor!=aParaBorder.iAutoColor)
+		return EFalse;
+	return ETrue;
+	}
+
+EXPORT_C TBullet::TBullet():
+	iCharacterCode(0x2022),
+	iHeightInTwips(0),
+	iHangingIndent(TRUE),
+	iColor(TLogicalRgb::ESystemForegroundColor),
+	iStyle(EBulletStyle),
+	iStartNumber(1),
+	iAlignment(ELeftAlign)
+/** The default C++ constructor constructs a TBullet, initializing the 
+character code to 0x2022, the height to zero, the colour to the system's 
+default foreground colour and the hanging indent to ETrue. The typeface 
+is not initialised. */
+	{
+	}
+
+EXPORT_C TBool TBullet::operator==(const TBullet& aBullet)const
+/** Compares two bullet points for equality. For two bullet points to be equal, 
+all data members must be equal.
+
+@param aBullet The bullet point to compare. 
+@return ETrue if the two bullet points are equal, EFalse if not. */
+	{
+	return iCharacterCode == aBullet.iCharacterCode &&
+		   iHeightInTwips == aBullet.iHeightInTwips &&
+		   iHangingIndent == aBullet.iHangingIndent &&
+		   iColor == aBullet.iColor &&
+		   iStyle == aBullet.iStyle &&
+		   iStartNumber == aBullet.iStartNumber &&
+		   iAlignment == aBullet.iAlignment &&
+		   iTypeface == aBullet.iTypeface;
+	}
+
+EXPORT_C CParaFormat* CParaFormat::NewL()
+/** Allocates and constructs a CParaFormat object. All attributes are 
+initialised with default values.
+
+@return The new CParaFormat object. */
+	{
+	return new(ELeave) CParaFormat;
+	}
+
+EXPORT_C CParaFormat* CParaFormat::NewLC()
+/** Allocates and constructs a CParaFormat object. All attributes are 
+initialised with default values. Leaves the object on the cleanup stack.
+
+@return The new CParaFormat object. */
+	{
+	CParaFormat* self=new(ELeave) CParaFormat;
+	CleanupStack::PushL(self);
+	return self;
+	}
+
+EXPORT_C CParaFormat* CParaFormat::NewL(const CParaFormat& aFormat)
+/** Allocates and constructs a new CParaFormat. All attributes are initialised 
+to the values contained in the aFormat argument.
+
+@param aFormat Paragraph format container whose values are used to initialise 
+the new CParaFormat. 
+@return The new CParaFormat object. */
+	{
+	CParaFormat* self = new(ELeave) CParaFormat(aFormat);
+	CleanupStack::PushL(self);
+	self->CopyL(aFormat);
+	CleanupStack::Pop();
+	return self;
+	}
+
+EXPORT_C CParaFormat::CParaFormat():
+	iTabList(NULL),
+	iParaBorderArray(NULL),
+	iFillColor(TLogicalRgb::ESystemBackgroundColor),
+	iLanguage(KParaDefaultLanguage),
+	iLeftMarginInTwips(KParaDefaultLeftMargin),
+	iRightMarginInTwips(KParaDefaultRightMargin),
+	iIndentInTwips(KParaDefaultIndent),
+	iHorizontalAlignment(KParaDefaultHorizAlign),
+	iVerticalAlignment(KParaDefaultVertAlign),
+	iLineSpacingInTwips(KParaDefaultLineSpacing),
+	iLineSpacingControl(KParaDefaultLineSpacingControl),
+	iSpaceBeforeInTwips(KParaDefaultSpaceBefore),
+	iSpaceAfterInTwips(KParaDefaultSpaceAfter),
+	iKeepTogether(KParaDefaultKeepTogether),
+	iKeepWithNext(KParaDefaultKeepWithNext),
+	iStartNewPage(KParaDefaultStartNewPage),
+	iWidowOrphan(KParaDefaultWidowOrphan),
+	iWrap(KParaDefaultWrap),
+	iBorderMarginInTwips(KParaDefaultBorderMargin),
+	iBullet(NULL),
+	iDefaultTabWidthInTwips(KParaDefaultTabWidth)
+/** The default C++ constructor constructs a new CParaFormat initialising all 
+attributes to the default settings.
+
+Note: This function allows a CParaFormat object to be created on the stack. This 
+should only be done if it is known in advance that the object will not be 
+used to store tab stops, bullets or borders. */
+	{
+	}
+
+
+CParaFormat::CParaFormat(const CParaFormat& aFormat):
+	iFillColor(aFormat.iFillColor),
+	iLanguage(aFormat.iLanguage),
+	iLeftMarginInTwips(aFormat.iLeftMarginInTwips),
+	iRightMarginInTwips(aFormat.iRightMarginInTwips),
+	iIndentInTwips(aFormat.iIndentInTwips),
+	iHorizontalAlignment(aFormat.iHorizontalAlignment),
+	iVerticalAlignment(aFormat.iVerticalAlignment),
+	iLineSpacingInTwips(aFormat.iLineSpacingInTwips),
+	iLineSpacingControl(aFormat.iLineSpacingControl),
+	iSpaceBeforeInTwips(aFormat.iSpaceBeforeInTwips),
+	iSpaceAfterInTwips(aFormat.iSpaceAfterInTwips),
+	iKeepTogether(aFormat.iKeepTogether),
+	iKeepWithNext(aFormat.iKeepWithNext),
+	iStartNewPage(aFormat.iStartNewPage),
+	iWidowOrphan(aFormat.iWidowOrphan),
+	iWrap(aFormat.iWrap),
+	iBorderMarginInTwips(aFormat.iBorderMarginInTwips),
+	iDefaultTabWidthInTwips(aFormat.iDefaultTabWidthInTwips)
+	{
+	}
+
+void CParaFormat::CreateTabListL()
+	{
+	if (!iTabList)
+		iTabList = new(ELeave) CArrayFixFlat<TTabStop>(ETabStoreGranularity);
+	}
+ 
+EXPORT_C CParaFormat::~CParaFormat()
+/** The destructor frees all resources owned by the paragraph format container 
+(tabs, borders and bullets), prior to its destruction. 
+
+Note that Strip() also sets the resource pointers to NULL. This is important 
+in case CParaFormat is on the stack and gets deleted twice: once by the cleanup 
+stack and once by exceptions being unwound. */
+	{
+	Strip();
+	}
+
+EXPORT_C void CParaFormat::CopyL(const CParaFormat& aFormat)
+/** Copies all attribute values from another paragraph format container.
+
+@param aFormat Contains the attribute values to copy. */
+	{
+	TParaFormatMask mask;
+	mask.SetAll();
+	CopyL(aFormat,mask);
+	}
+
+EXPORT_C void CParaFormat::CopyL(const CParaFormat& aFormat,const TParaFormatMask& aMask)
+/** Copies selected attribute values from another paragraph format container. 
+Only the attributes which are set in the mask are copied.
+
+@param aFormat Contains the attribute values to copy. 
+@param aMask Bitmask specifying the attributes to copy. */
+	{
+	if (aMask.AttribIsSet(EAttParaLanguage))
+		iLanguage=aFormat.iLanguage;
+	if (aMask.AttribIsSet(EAttFillColor))
+		iFillColor=aFormat.iFillColor;
+	if (aMask.AttribIsSet(EAttLeftMargin))
+		iLeftMarginInTwips=aFormat.iLeftMarginInTwips;
+	if (aMask.AttribIsSet(EAttRightMargin))
+		iRightMarginInTwips=aFormat.iRightMarginInTwips;
+	if (aMask.AttribIsSet(EAttIndent))
+		iIndentInTwips=aFormat.iIndentInTwips;
+	if (aMask.AttribIsSet(EAttAlignment))
+		iHorizontalAlignment=aFormat.iHorizontalAlignment;
+	if (aMask.AttribIsSet(EAttVerticalAlignment))
+		iVerticalAlignment=aFormat.iVerticalAlignment;
+	if (aMask.AttribIsSet(EAttLineSpacing))
+		iLineSpacingInTwips=aFormat.iLineSpacingInTwips;
+	if (aMask.AttribIsSet(EAttLineSpacingControl))
+		iLineSpacingControl=aFormat.iLineSpacingControl;
+	if (aMask.AttribIsSet(EAttSpaceBefore))
+		iSpaceBeforeInTwips=aFormat.iSpaceBeforeInTwips;
+	if (aMask.AttribIsSet(EAttSpaceAfter))
+		iSpaceAfterInTwips=aFormat.iSpaceAfterInTwips;
+	if (aMask.AttribIsSet(EAttKeepTogether))
+		iKeepTogether=aFormat.iKeepTogether;
+	if (aMask.AttribIsSet(EAttKeepWithNext))
+		iKeepWithNext=aFormat.iKeepWithNext;
+	if (aMask.AttribIsSet(EAttStartNewPage))
+		iStartNewPage=aFormat.iStartNewPage;
+	if (aMask.AttribIsSet(EAttWidowOrphan))
+		iWidowOrphan=aFormat.iWidowOrphan;
+	if (aMask.AttribIsSet(EAttWrap))
+		iWrap=aFormat.iWrap;
+
+	// Copy borders; create a border array only if necessary.
+	if (iParaBorderArray || aFormat.iParaBorderArray)
+		{
+		if (!iParaBorderArray)
+			iParaBorderArray = new(ELeave) TParaBorderArray;
+		if (aMask.AttribIsSet(EAttTopBorder))
+			iParaBorderArray->iBorder[EParaBorderTop] = aFormat.ParaBorder(EParaBorderTop);
+		if (aMask.AttribIsSet(EAttBottomBorder))
+			iParaBorderArray->iBorder[EParaBorderBottom] = aFormat.ParaBorder(EParaBorderBottom);
+		if (aMask.AttribIsSet(EAttLeftBorder))
+			iParaBorderArray->iBorder[EParaBorderLeft] = aFormat.ParaBorder(EParaBorderLeft);
+		if (aMask.AttribIsSet(EAttRightBorder))
+			iParaBorderArray->iBorder[EParaBorderRight] = aFormat.ParaBorder(EParaBorderRight);
+		TParaBorder default_border;
+		TBool borders_are_default = TRUE;
+		for (int i = 0; i < 4; i++)
+			if (iParaBorderArray->iBorder[i] != default_border)
+				{
+				borders_are_default = FALSE;
+				break;
+				}
+		if (borders_are_default)
+			RemoveAllBorders();
+		}
+
+	if (iBullet || aFormat.iBullet)
+		{
+		if (aMask.AttribIsSet(EAttBullet))
+			{
+			if (aFormat.iBullet && aFormat.iBullet->iStyle != TBullet::ENullStyle)
+				{
+				if (!iBullet)
+					iBullet = new(ELeave) TBullet;
+				*iBullet = *aFormat.iBullet;
+				}
+			else
+				{
+				delete iBullet;
+				iBullet = NULL;
+				}
+			}
+		}
+
+	if (aMask.AttribIsSet(EAttDefaultTabWidth))
+		iDefaultTabWidthInTwips = aFormat.iDefaultTabWidthInTwips;
+
+	if (iTabList || aFormat.iTabList)
+		{
+		if (aMask.AttribIsSet(EAttTabStop))
+			{
+			RemoveAllTabs();
+			if (aFormat.iTabList && aFormat.iTabList->Count())
+				{
+				CreateTabListL();
+				iTabList->InsertL(0,&(aFormat.iTabList->At(0)),aFormat.iTabList->Count());
+				}
+			}
+		}
+	}
+
+EXPORT_C TBool CParaFormat::IsEqual(const CParaFormat& aFormat,const TParaFormatMask& aMask) const
+/** Compares selected attribute values for equality. Only the attributes 
+specified in the mask are involved in the comparison.
+
+@param aFormat Contains the attribute values to compare. 
+@param aMask Bitmask specifying the attributes to compare. 
+@return ETrue if the two format containers have the same values for the
+attributes specified in the mask, EFalse if not. */
+	{
+	if (aMask.AttribIsSet(EAttParaLanguage))
+		{
+		if (iLanguage!=aFormat.iLanguage)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFillColor))
+		{
+		if (iFillColor!=aFormat.iFillColor)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttLeftMargin))
+		{
+		if (iLeftMarginInTwips!=aFormat.iLeftMarginInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttRightMargin))
+		{
+		if (iRightMarginInTwips!=aFormat.iRightMarginInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttIndent))
+		{
+		if (iIndentInTwips!=aFormat.iIndentInTwips)	
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttAlignment))
+		{
+		if (iHorizontalAlignment!=aFormat.iHorizontalAlignment)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttVerticalAlignment))
+		{
+		if (iVerticalAlignment!=aFormat.iVerticalAlignment)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttLineSpacing))
+		{
+		if (iLineSpacingInTwips!=aFormat.iLineSpacingInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttLineSpacingControl))
+		{
+		if (iLineSpacingControl!=aFormat.iLineSpacingControl)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttSpaceBefore))
+		{
+		if (iSpaceBeforeInTwips!=aFormat.iSpaceBeforeInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttSpaceAfter))
+		{
+		if (iSpaceAfterInTwips!=aFormat.iSpaceAfterInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttKeepTogether))
+		{
+		if (iKeepTogether!=aFormat.iKeepTogether)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttKeepWithNext))
+		{
+		if (iKeepWithNext!=aFormat.iKeepWithNext)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttStartNewPage))
+		{
+		if (iStartNewPage!=aFormat.iStartNewPage)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttWidowOrphan))
+		{
+		if (iWidowOrphan!=aFormat.iWidowOrphan)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttWrap))
+		{
+		if (iWrap!=aFormat.iWrap)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttBorderMargin))
+		{
+		if (iBorderMarginInTwips!=aFormat.iBorderMarginInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttTopBorder))
+		{
+		if (iParaBorderArray)
+			{
+			if (ParaBorder(EParaBorderTop)!=aFormat.ParaBorder(EParaBorderTop))
+				return EFalse;
+			}
+		else
+			{
+			if (aFormat.ParaBorder(EParaBorderTop).iLineStyle!=TParaBorder::ENullLineStyle)
+				return EFalse;
+			}
+		}
+	if (aMask.AttribIsSet(EAttBottomBorder))
+		{
+		if (iParaBorderArray)
+			{
+			if (ParaBorder(EParaBorderBottom)!=aFormat.ParaBorder(EParaBorderBottom))
+				return EFalse;
+			}
+		else
+			{
+			if (aFormat.ParaBorder(EParaBorderBottom).iLineStyle!=TParaBorder::ENullLineStyle)
+				return EFalse;
+			}
+		}
+	if (aMask.AttribIsSet(EAttLeftBorder))
+		{
+		if (iParaBorderArray)
+			{
+			if (ParaBorder(EParaBorderLeft)!=aFormat.ParaBorder(EParaBorderLeft))
+				return EFalse;
+			}
+		else
+			{
+			if (aFormat.ParaBorder(EParaBorderLeft).iLineStyle!=TParaBorder::ENullLineStyle)
+				return EFalse;
+			}
+		}
+	if (aMask.AttribIsSet(EAttRightBorder))
+		{
+		if (iParaBorderArray)
+			{
+			if (ParaBorder(EParaBorderRight)!=aFormat.ParaBorder(EParaBorderRight))
+				return EFalse;
+			}
+		else
+			{
+			if (aFormat.ParaBorder(EParaBorderRight).iLineStyle!=TParaBorder::ENullLineStyle)
+				return EFalse;
+			}
+		}
+	if (aMask.AttribIsSet(EAttBullet))
+		{
+		if (iBullet)
+			{
+			if (!aFormat.iBullet)
+				return EFalse;
+			if (*iBullet!=*aFormat.iBullet)
+				return EFalse;
+			}
+		else
+			{
+			if (aFormat.iBullet)
+				return EFalse;
+			}
+		}
+	if (aMask.AttribIsSet(EAttDefaultTabWidth))
+		{
+		if (iDefaultTabWidthInTwips!=aFormat.iDefaultTabWidthInTwips)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttTabStop))
+		{
+		if (TabCount()>0)
+			{// Check the tablists are the same.
+			if (TabCount()!=aFormat.TabCount())
+				return EFalse;
+			TInt tabCount=TabCount();
+			for (TInt index=0;index<tabCount;index++)
+				{// Check each stored tab is the same
+				if (TabStop(index)!=aFormat.TabStop(index))
+					return EFalse;
+				}
+			}
+		else if (aFormat.TabCount()>0)
+			return EFalse;
+		}
+	return ETrue;
+	}
+
+EXPORT_C TBool CParaFormat::IsEqual(const CParaFormat& aFormat) const
+/** Compares all attribute values for equality.
+
+@param aFormat Contains the attribute values to compare. 
+@return ETrue if the two format containers have the same values for all 
+attributes, EFalse if not. */
+	{
+	TParaFormatMask mask;
+	mask.SetAll();
+	return IsEqual(aFormat,mask);
+	}
+ 
+EXPORT_C void CParaFormat::Strip()
+/** Deletes all paragraph borders, bullets and tab stops. No other 
+attributes are affected. */
+	{
+	RemoveAllTabs();
+	RemoveAllBorders();
+	delete iBullet;
+	iBullet = NULL;
+	}
+
+EXPORT_C void CParaFormat::Reset()
+/** Resets all paragraph format attributes to their default values. All tab 
+stops, paragraph borders and bullet points which have been allocated are 
+deleted and set to NULL. */
+	{
+	ResetNonDestructive();
+	Strip();
+	}
+	
+EXPORT_C void CParaFormat::ResetNonDestructive()
+/** Resets all paragraph format attributes to their default values, but any 
+allocated tab stops, bullet points and paragraph borders are preserved. */
+	{
+	iLanguage=KParaDefaultLanguage;
+	iFillColor=TLogicalRgb::ESystemBackgroundColor;
+	iLeftMarginInTwips=KParaDefaultLeftMargin;
+	iRightMarginInTwips=KParaDefaultRightMargin;
+	iIndentInTwips=KParaDefaultIndent;
+	iHorizontalAlignment=KParaDefaultHorizAlign;
+	iVerticalAlignment=KParaDefaultVertAlign;
+	iLineSpacingInTwips=KParaDefaultLineSpacing;
+	iLineSpacingControl=KParaDefaultLineSpacingControl;
+	iSpaceBeforeInTwips=KParaDefaultSpaceBefore;
+	iSpaceAfterInTwips=KParaDefaultSpaceAfter;
+	iKeepTogether=KParaDefaultKeepTogether;
+	iKeepWithNext=KParaDefaultKeepWithNext;
+	iStartNewPage=KParaDefaultStartNewPage;
+	iWidowOrphan=KParaDefaultWidowOrphan;
+	iWrap=KParaDefaultWrap;
+	iBorderMarginInTwips=KParaDefaultBorderMargin;
+	iDefaultTabWidthInTwips=KParaDefaultTabWidth;
+	}
+
+EXPORT_C void CParaFormat::StoreTabL(const TTabStop& aTabStop)
+/** Adds a tab stop to the list of tab stops, maintaining the ordering of the 
+list, (ascending order of twips position). Multiple tabs with the same twips 
+position are not allowed, so that if aTabStop shares the same twips position 
+as an existing tab stop, regardless of its alignment, the existing tab stop is 
+replaced by aTabStop.
+
+@param aTabStop The tab stop to be stored. */
+	{
+	CreateTabListL();
+	TKeyArrayFix tabKey(_FOFF(TTabStop,iTwipsPosition),ECmpTUint32);
+	TInt tabNumber;
+	CArrayFixFlat<TTabStop>& tabs=*iTabList;
+	if (tabs.FindIsq(aTabStop,tabKey,tabNumber)==0)
+		tabs[tabNumber]=aTabStop;		// found one at this position
+	else
+		tabs.InsertL(tabNumber,aTabStop);	// add the new one
+	}
+
+EXPORT_C void CParaFormat::RemoveTab(TInt aTabPosition)
+/** Deletes a tab stop identified by its twips position. If the specified 
+tab stop does not exist, the function has no effect.
+	
+@param aTabTwipsPosition The twips position of the tab stop to remove. */
+
+	{
+	TInt tabNumber=LocateTab(aTabPosition);  // will return KTabNotFound if no tab list present
+	if (tabNumber!=KTabNotFound)
+		{
+		iTabList->Delete(tabNumber);
+		iTabList->Compress();
+		}
+	}
+
+EXPORT_C const TTabStop CParaFormat::TabStop(TInt aTabIndex) const
+/** Gets the tab stop located at the specified index within the tab list 
+(counting from zero). Tab stops are ordered in ascending order of twips 
+position. If the object has no tab list, then a default tab stop is returned.
+
+@param aTabIndex The offset of the tab stop in the tab list. Must be less 
+than the total number of tab stops, or a panic occurs. To find the total number 
+of tab stops, use TabCount(). 
+@return The tab stop located at the specified index. */
+	{
+	__ASSERT_ALWAYS(aTabIndex<TabCount(),Panic(ETabNotFound));
+	
+	return (iTabList)
+		? TTabStop((*iTabList)[aTabIndex])
+		: TTabStop();
+	}
+
+EXPORT_C TInt CParaFormat::LocateTab(TInt aTabPosition) const
+/** Locates the tab stop specified by its twips position, and returns its
+offset in the tab list.
+
+@param aTabPosition The twips position of the tab stop.
+@return The tab stop's index within the tab list (counting from zero). 
+KTabNotFound indicates that  no tab stop has the specified twips 
+position, or that no tab list has been allocated. */
+	{
+	if (!iTabList)
+		return KTabNotFound;
+	TKeyArrayFix tabKey(_FOFF(TTabStop,iTwipsPosition),ECmpTUint32);
+	TInt tabNumber=0;
+	TTabStop tab;
+	tab.iTwipsPosition=aTabPosition;
+	TInt error=iTabList->FindIsq(tab,tabKey,tabNumber);
+	return error ?KTabNotFound :tabNumber;
+	}
+
+EXPORT_C void CParaFormat::SetParaBorderL(TParaBorderSide aSide,const TParaBorder& aBorder)
+/** Sets one side of the object's paragraph border. If a border on the specified 
+side already exists, it is replaced.
+
+Note: Setting a single side of the object's paragraph border incurs the overhead 
+of allocating storage for the three other sides, which are assigned default 
+values.
+
+@param aSide The side for the paragraph border. 
+@param aBorder Specification for the paragraph border. */
+	{
+	TParaBorderArray* borders=iParaBorderArray;
+	if (!borders)
+		iParaBorderArray=borders=new(ELeave) TParaBorderArray;
+	borders->iBorder[aSide]=aBorder;
+	}
+
+EXPORT_C const TParaBorder CParaFormat::ParaBorder(TParaBorderSide aSide)const
+/** Gets the paragraph border on the side specified. If no paragraph border 
+array has been allocated, returns a default paragraph border.
+
+@param aSide The side for the paragraph border. 
+@return The paragraph border on the specified side. */
+	{
+	if (iParaBorderArray)
+		return iParaBorderArray->iBorder[aSide];
+	return TParaBorder();
+	}
+
+EXPORT_C void CParaFormat::RemoveAllBorders()
+/** Deletes all paragraph borders. */
+	{
+	delete iParaBorderArray;
+	iParaBorderArray = NULL;
+	}
+
+EXPORT_C TBool CParaFormat::AllBordersEqual(const CParaFormat& aFormat)const
+/** Tests whether all paragraph borders in the specified paragraph format 
+container are identical to the paragraph borders of this paragraph format 
+container.
+
+@param aFormat Contains the set of paragraph borders to compare. 
+@return ETrue if both objects have exactly the same set of paragraph borders. 
+EFalse if not. */
+	{
+	if (aFormat.ParaBorder(EParaBorderTop)!=ParaBorder(EParaBorderTop))
+		return EFalse;
+	if (aFormat.ParaBorder(EParaBorderBottom)!=ParaBorder(EParaBorderBottom))
+		return EFalse;
+	if (aFormat.ParaBorder(EParaBorderLeft)!=ParaBorder(EParaBorderLeft))
+		return EFalse;
+	if (aFormat.ParaBorder(EParaBorderRight)!=ParaBorder(EParaBorderRight))
+		return EFalse;
+	return ETrue;
+	}
+ 
+EXPORT_C TBool CParaFormat::IsBorderEqual(TParaBorderSide aSide,const CParaFormat& aFormat)const
+/** Tests whether the paragraph border located on the specified side is the same 
+as the border on the corresponding side in this object. For two borders to 
+be equal, they must both either be set or unset, and if set, they must have 
+the same characteristics.
+
+@param aSide Indicates which side should be compared. 
+@param aFormat Contains the paragraph border to compare. 
+@return ETrue if the border sides are identical. EFalse if not. */
+	{
+	return aFormat.ParaBorder(aSide)==ParaBorder(aSide);
+	}
+
+ EXPORT_C void TParaFormatMask::SetAll()
+/** Sets all attribute flags in the paragraph format mask. */
+	{
+	iGuard = KMaxTUint;
+	}
+ 
+EXPORT_C void TParaFormatMask::ClearAll()
+/** Clears all attribute flags in the paragraph format mask. */
+	{
+	iGuard=0;
+	}
+
+EXPORT_C  TBool TParaFormatMask::operator==(const TParaFormatMask& aMask)const
+/** Compares two paragraph format masks for equality.
+
+@param aMask The mask to compare. 
+@return ETrue if all flags are the same in both masks. EFalse if any differ. */
+	{
+	return (iGuard & KParFormatBits) == (aMask.iGuard & KParFormatBits);
+	}
+
+EXPORT_C TFontPresentation::TFontPresentation():
+	iTextColor(TLogicalRgb::ESystemForegroundColor),
+	iHighlightColor(TLogicalRgb::ESystemForegroundColor),
+	iHighlightStyle(EFontHighlightNone),
+	iStrikethrough(EStrikethroughOff),
+	iUnderline(EUnderlineOff),
+	iHiddenText(EFalse),
+	iPictureAlignment(EAlignBaseLine)
+/** The default C++ constructor constructs a TFontPresentation object, 
+initializing all member data to default values. For details of these values, 
+see the table below. */
+	{
+	}
+
+EXPORT_C TBool TFontPresentation::IsEqual(const TFontPresentation& aFontPresentation,const TCharFormatMask& aMask) const
+/** Compares selected attribute values for equality. Only the attributes 
+specified in the mask are involved in the comparison.
+
+@param aFontPresentation Contains the attribute values to compare. 
+@param aMask Bitmask specifying the attributes involved in the comparison. 
+@return ETrue if the two objects have the same values for the attributes 
+specified in the mask, EFalse if not. */
+	{
+	// Compare two font presentations, comparing only the attributes selected by the mask.
+	if (aMask.AttribIsSet(EAttColor))
+		{
+		if (iTextColor!=aFontPresentation.iTextColor)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontHighlightColor))
+		{
+		if (iHighlightColor!=aFontPresentation.iHighlightColor)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontHighlightStyle))
+		{
+		if (iHighlightStyle!=aFontPresentation.iHighlightStyle)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontStrikethrough))
+		{
+		if (iStrikethrough!=aFontPresentation.iStrikethrough)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontUnderline))
+		{
+		if (iUnderline!=aFontPresentation.iUnderline)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontHiddenText))
+		{
+		if (iHiddenText!=aFontPresentation.iHiddenText)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontPictureAlignment))
+		{
+		if (iPictureAlignment!=aFontPresentation.iPictureAlignment)
+			return EFalse;
+		}
+	return ETrue;
+	}
+
+EXPORT_C TCharFormat::TCharFormat():
+	iLanguage(0)
+/** Allocates and constructs a TCharFormat object. The font-independent 
+attributes are initialised with default values. The language is initialised 
+to zero. The font (iFontSpec) is set to be proportional and serif and to have 
+a height of 200 twips. The typeface name is not initialised. */
+	{
+	iFontSpec.iTypeface.SetAttributes(TTypeface::EProportional | TTypeface::ESerif);
+	iFontSpec.iHeight = 200;
+	}
+
+EXPORT_C TCharFormat::TCharFormat(const TDesC &aTypefaceName,TInt aHeight):
+	iLanguage(0),
+	iFontSpec(aTypefaceName,aHeight)
+/** The C++ constructor is used to construct the TCharFormat object with a font 
+(typeface name and font height). The font-independent attributes are initialised 
+to default values; for details, see class TFontPresentation. The language 
+is initialised to zero.
+
+@param aTypefaceName Specifies the typeface name. 
+@param aHeight Specifies the font height in twips. */
+	{
+	}
+
+EXPORT_C TBool TCharFormat::IsEqual(const TCharFormat& aFormat,const TCharFormatMask& aMask) const
+/** Compares selected attribute values for equality. Only the attributes 
+specified in the mask are involved in the comparison.
+
+@param aFormat Contains the attribute values to compare. 
+@param aMask Bitmask specifying the attributes to compare. 
+@return ETrue if the two format containers have the same values for the 
+attributes specified in the mask, EFalse if not. */
+	{
+	if (aMask.AttribIsSet(EAttCharLanguage))
+		{
+		if (iLanguage!=aFormat.iLanguage)
+			return EFalse;
+		}
+	if (!iFontPresentation.IsEqual(aFormat.iFontPresentation,aMask))
+		return EFalse;
+	if (aMask.AttribIsSet(EAttFontHeight))
+		{
+		if (iFontSpec.iHeight!=aFormat.iFontSpec.iHeight)
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontTypeface))
+		{
+		if (!(iFontSpec.iTypeface==aFormat.iFontSpec.iTypeface))
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontPosture))
+		{
+		if (iFontSpec.iFontStyle.Posture()!=aFormat.iFontSpec.iFontStyle.Posture())
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontStrokeWeight))
+		{
+		if (iFontSpec.iFontStyle.StrokeWeight()!=aFormat.iFontSpec.iFontStyle.StrokeWeight())
+			return EFalse;
+		}
+	if (aMask.AttribIsSet(EAttFontPrintPos))
+		{
+		if (iFontSpec.iFontStyle.PrintPosition()!=aFormat.iFontSpec.iFontStyle.PrintPosition())
+			return EFalse;
+		}
+	return ETrue;
+	}
+
+
+EXPORT_C TBool TCharFormat::IsEqual(const TCharFormat& aFormat) const
+/** Compares all attribute values for equality.
+
+@param aFormat Contains the attribute values to compare. 
+@return ETrue if the two format containers have the same values for all 
+attributes, EFalse if not. */
+	{
+	TCharFormatMask mask;
+	mask.SetAll();
+	return IsEqual(aFormat,mask);
+	}
+
+EXPORT_C void TCharFormatMask::SetAll()
+/** Sets all attribute flags in the character format mask. */
+	{
+	iGuard = KMaxTUint;
+	}
+
+EXPORT_C void TCharFormatMask::ClearAll()
+/** Clears all attribute flags in the character format mask. */
+	{
+	iGuard = 0;
+	}
+
+EXPORT_C  TBool TCharFormatMask::operator==(const TCharFormatMask& aMask)const
+/** Compares two character format masks for equality.
+
+@param aMask The mask to compare. 
+@return ETrue if all flags are the same in both masks. EFalse if any differ. */
+	{
+	return (iGuard & KCharFormatBits) == (aMask.iGuard & KCharFormatBits);
+	}