1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/textandloc/textrendering/texthandling/stext/TXTSTYLE.CPP Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,642 @@
1.4 +/*
1.5 +* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
1.6 +* All rights reserved.
1.7 +* This component and the accompanying materials are made available
1.8 +* under the terms of "Eclipse Public License v1.0"
1.9 +* which accompanies this distribution, and is available
1.10 +* at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.11 +*
1.12 +* Initial Contributors:
1.13 +* Nokia Corporation - initial contribution.
1.14 +*
1.15 +* Contributors:
1.16 +*
1.17 +* Description:
1.18 +*
1.19 +*/
1.20 +
1.21 +
1.22 +#include <e32std.h>
1.23 +#include <e32base.h>
1.24 +#include <s32strm.h>
1.25 +
1.26 +#include "TXTSTYLE.H"
1.27 +#include "TXTFRMAT.H"
1.28 +#include "TXTSTD.H"
1.29 +
1.30 +#include "OstTraceDefinitions.h"
1.31 +#ifdef OST_TRACE_COMPILER_IN_USE
1.32 +#include "TXTSTYLETraces.h"
1.33 +#endif
1.34 +
1.35 +#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
1.36 +#include "TXTFMLYR_INTERNAL.H"
1.37 +#include "TXTSTYLE_INTERNAL.H"
1.38 +#endif
1.39 +
1.40 +// Return the handle of a new paragraph style
1.41 +
1.42 +
1.43 +EXPORT_C CParagraphStyle* CParagraphStyle::NewL(const CParaFormatLayer& aGlobalParaFormatLayer,
1.44 + const CCharFormatLayer& aGlobalCharFormatLayer)
1.45 +/** Allocates and constructs a CParagraphStyle object whose formatting is based
1.46 +on a global paragraph and character format layer. The type UID is initialised
1.47 +to KUserDefinedParagraphStyleUid. The outline level is not initialised.
1.48 +
1.49 +@param aGlobalParaFormatLayer The paragraph format layer on which the style's
1.50 +paragraph formatting is based.
1.51 +@param aGlobalCharFormatLayer The character format layer on which the style's
1.52 +character formatting is based.
1.53 +@return Pointer to the new CParagraphStyle object. */
1.54 + {
1.55 + CParagraphStyle* self=new(ELeave) CParagraphStyle();
1.56 + CleanupStack::PushL(self);
1.57 + self->ConstructL(aGlobalParaFormatLayer,aGlobalCharFormatLayer);
1.58 + CleanupStack::Pop();
1.59 + return self;
1.60 + }
1.61 +
1.62 +
1.63 +CParagraphStyle::CParagraphStyle():
1.64 + iType(KUserDefinedParagraphStyleUid)
1.65 + {
1.66 + }
1.67 +
1.68 +
1.69 +// Create style and base it on the specified 'Normal' layers
1.70 +void CParagraphStyle::ConstructL(const CParaFormatLayer& aGlobalParaFormatLayer,
1.71 + const CCharFormatLayer& aGlobalCharFormatLayer)
1.72 + {
1.73 + SetBase(&aGlobalParaFormatLayer);
1.74 + //
1.75 + // Force para format layer storage allocation with empty layer
1.76 + TParaFormatMask paraMask;
1.77 + SetL((CParaFormat*)NULL,paraMask);
1.78 + //
1.79 + // Force char format layer storage allocation with empty layer;
1.80 +/* TCharFormat format;
1.81 + TCharFormatMask mask;
1.82 + iCharFormatLayer=CCharFormatLayer::NewL(format,mask);
1.83 +*/
1.84 + iCharFormatLayer=CCharFormatLayer::NewL();
1.85 + iCharFormatLayer->SetBase(&aGlobalCharFormatLayer);
1.86 + }
1.87 +
1.88 +
1.89 +EXPORT_C CParagraphStyle::~CParagraphStyle()
1.90 +/** The destructor frees all resources owned by the object, prior to its destruction. */
1.91 + {
1.92 + delete iCharFormatLayer;
1.93 + }
1.94 +
1.95 +
1.96 +EXPORT_C CFormatLayer* CParagraphStyle::DoCloneL()const
1.97 + {
1.98 + const CCharFormatLayer* charLayer=STATIC_CAST(const CCharFormatLayer*,iCharFormatLayer->SenseBase());
1.99 + CParagraphStyle* clone=CParagraphStyle::NewL(STATIC_CAST(const CParaFormatLayer&,*SenseBase()),*charLayer);
1.100 + CleanupStack::PushL(clone);
1.101 + CloneLayerL(clone); // clones the paragraph format layer
1.102 + delete clone->iCharFormatLayer;
1.103 + clone->iCharFormatLayer=NULL; // necessary precaution if next instruction leaves
1.104 + clone->iCharFormatLayer=iCharFormatLayer->CloneL(); // clones the character format layer
1.105 + clone->iCharFormatLayer->SetBase(charLayer); // restore the based on link
1.106 + CleanupStack::Pop(); // clone
1.107 + //
1.108 + clone->SetType(Type());
1.109 + clone->SetOutlineLevel(OutlineLevel());
1.110 + clone->iName=iName;
1.111 + //
1.112 + return clone;
1.113 + }
1.114 +
1.115 +
1.116 +
1.117 +
1.118 +EXPORT_C TUid CParagraphStyle::Type()const
1.119 +/** Gets the style's type UID.
1.120 +
1.121 +@return The style's type UID. */
1.122 + {return iType;}
1.123 +
1.124 +
1.125 +CParagraphStyle* CParagraphStyle::NewL(RReadStream& aStream,
1.126 + const CParaFormatLayer& aGlobalParaFormatLayer,
1.127 + const CCharFormatLayer& aGlobalCharFormatLayer)
1.128 + {
1.129 + CParagraphStyle* self=new(ELeave) CParagraphStyle();
1.130 + CleanupStack::PushL(self);
1.131 + self->ConstructL(aGlobalParaFormatLayer,aGlobalCharFormatLayer);
1.132 + self->InternalizeL(aStream,&aGlobalParaFormatLayer,&aGlobalCharFormatLayer);
1.133 + CleanupStack::Pop();
1.134 + return self;
1.135 + }
1.136 +
1.137 +
1.138 +// Load into this style from the specified readStream. Base this style on the layer aBase - Default NULL
1.139 +void CParagraphStyle::InternalizeL(RReadStream& aStream,const CFormatLayer* aParaLayerBase,const CFormatLayer* aCharLayerBase)
1.140 + {
1.141 + aStream>> iName;
1.142 + aStream>> iType;
1.143 + iOutlineLevel=aStream.ReadInt32L();
1.144 + iCharFormatLayer->InternalizeL(aStream,aCharLayerBase);
1.145 + //
1.146 + CParaFormatLayer::InternalizeL(aStream,aParaLayerBase);
1.147 + }
1.148 +
1.149 +
1.150 +// Save the style in the specified WriteStream. The based on link is *NOT* stored.
1.151 +void CParagraphStyle::ExternalizeL(RWriteStream& aStream)const
1.152 + {
1.153 + aStream<< iName;
1.154 + aStream<< iType;
1.155 + aStream.WriteInt32L(iOutlineLevel);
1.156 + aStream<< *iCharFormatLayer;
1.157 + //
1.158 + CParaFormatLayer::ExternalizeL(aStream);
1.159 + }
1.160 +
1.161 +
1.162 +DLLEXPORT_C void CStyleList::__DbgTestInvariant()const
1.163 +// Provides class invariants. Explanations below:
1.164 +//
1.165 + {
1.166 +#ifdef _DEBUG
1.167 + TInt styleCount=Count();
1.168 + for (TInt nn=0;nn<styleCount;nn++)
1.169 + {
1.170 + RParagraphStyleInfo info=iList->At(nn);
1.171 + if (info.iStyleForNextPara)
1.172 + {
1.173 + TInt index=IndexByPtr(info.iStyleForNextPara);
1.174 + // ASSERT: The style-to-follow is present in the list.
1.175 + if (!((info.iStyleForNextPara==NULL) ||
1.176 + ((info.iStyleForNextPara) && (index!=KErrNotFound && index>=0 && index<styleCount))))
1.177 + {
1.178 + OstTrace0( TRACE_DUMP, CSTYLELIST_DBGTESTINVARIANT, "Invariant" );
1.179 + }
1.180 + __ASSERT_DEBUG(
1.181 + (info.iStyleForNextPara==NULL) ||
1.182 + ((info.iStyleForNextPara) && (index!=KErrNotFound && index>=0 && index<styleCount)),User::Invariant());
1.183 + }
1.184 + }
1.185 +#endif
1.186 + }
1.187 +
1.188 +
1.189 +
1.190 +
1.191 +EXPORT_C CStyleList* CStyleList::NewL(TInt aCapacity /*=KMaxStyleListGranularity*/)
1.192 +/** Allocates and constructs an empty CStyleList object with an array granularity.
1.193 +
1.194 +@param aCapacity The number of entries by which the array of styles expands
1.195 +when its buffer is reallocated. By default, KMaxStyleListGranularity (= 4).
1.196 +Must be positive or a panic occurs.
1.197 +@return Pointer to the new style list. */
1.198 + {
1.199 + CStyleList* self=new(ELeave) CStyleList();
1.200 + CleanupStack::PushL(self);
1.201 + self->ConstructL(aCapacity);
1.202 + CleanupStack::Pop();
1.203 + return self;
1.204 + }
1.205 +
1.206 +
1.207 +EXPORT_C CStyleList* CStyleList::NewL(RReadStream& aStream,
1.208 + const CParaFormatLayer* aGlobalParaFormatLayer,
1.209 + const CCharFormatLayer* aGlobalCharFormatLayer)
1.210 +/** Allocates and constructs a CStyleList, restoring its contents from the specified
1.211 +stream store. Each style in the list is set to be based on the global format
1.212 +layers specified.
1.213 +
1.214 +@param aStream Stream store from which the style list is restored.
1.215 +@param aGlobalParaFormatLayer Pointer to the global paragraph format layer
1.216 +on which all styles in the list are based.
1.217 +@param aGlobalCharFormatLayer Pointer to the global character format layer
1.218 +on which all styles in the list are based.
1.219 +@return Pointer to the new style list. */
1.220 + {
1.221 + CStyleList* self=new(ELeave) CStyleList();
1.222 + CleanupStack::PushL(self);
1.223 + self->InternalizeL(aStream,aGlobalParaFormatLayer,aGlobalCharFormatLayer);
1.224 + CleanupStack::Pop();
1.225 + return self;
1.226 + }
1.227 +
1.228 +
1.229 +EXPORT_C CStyleList::CStyleList()
1.230 + {
1.231 + }
1.232 +
1.233 +
1.234 +EXPORT_C void CStyleList::ConstructL(TInt aCount)
1.235 +// Allocate the style list.
1.236 +//
1.237 + {
1.238 + iList=new(ELeave) CArrayFixFlat<RParagraphStyleInfo>(aCount);
1.239 + }
1.240 +
1.241 +
1.242 +
1.243 +
1.244 +EXPORT_C CStyleList::~CStyleList()
1.245 +/** Deletes all the entries in the list and the list itself. */
1.246 + {
1.247 + KillStyleList();
1.248 + }
1.249 +
1.250 +
1.251 +
1.252 +
1.253 +EXPORT_C const RParagraphStyleInfo& CStyleList::At(TInt aIndex)const
1.254 +/** Gets a style from the style list, from its index into the array. Two versions
1.255 +are supplied. The compiler chooses the appropriate version based on the use
1.256 +made of the returned reference. If it is used in an expression where that
1.257 +reference can be modified, then the non-const version is chosen.
1.258 +
1.259 +@param aIndex The index of the style into the list. The first style is at
1.260 +position zero. Must be within the bounds of the array, or a panic occurs.
1.261 +@return A const reference to the style at position aIndex in the array.
1.262 +@return A non-const reference to the style at position aIndex in the array. */
1.263 + {
1.264 + if (!iList)
1.265 + {
1.266 + OstTrace0( TRACE_FATAL, CSTYLELIST_AT, "EStyleIntegrityError" );
1.267 + }
1.268 + __ASSERT_ALWAYS(iList,Panic(EStyleIntegrityError));
1.269 + if (aIndex<0 || aIndex>=iList->Count())
1.270 + {
1.271 + OstTrace0( TRACE_DUMP, DUP3_CSTYLELIST_AT, "EStyleIndexOutOfRange" );
1.272 + }
1.273 + __ASSERT_DEBUG(aIndex>=0 && aIndex<iList->Count(),Panic(EStyleIndexOutOfRange));
1.274 +
1.275 + return (*iList)[aIndex];
1.276 + }
1.277 +
1.278 +
1.279 +EXPORT_C RParagraphStyleInfo& CStyleList::At(TInt aIndex)
1.280 + {
1.281 + if (!iList)
1.282 + {
1.283 + OstTrace0( TRACE_FATAL, DUP2_CSTYLELIST_AT, "EStyleIntegrityError" );
1.284 + }
1.285 + __ASSERT_ALWAYS(iList,Panic(EStyleIntegrityError));
1.286 + if (aIndex<0 || aIndex>=iList->Count())
1.287 + {
1.288 + OstTrace0( TRACE_DUMP, DUP1_CSTYLELIST_AT, "EStyleIndexOutOfRange" );
1.289 + }
1.290 + __ASSERT_DEBUG(aIndex>=0 && aIndex<iList->Count(),Panic(EStyleIndexOutOfRange));
1.291 +
1.292 + return (*iList)[aIndex];
1.293 + }
1.294 +
1.295 +
1.296 +
1.297 +EXPORT_C void CStyleList::Reset()
1.298 + /** Deletes the contents of the list. */
1.299 + {
1.300 + __TEST_INVARIANT;
1.301 +
1.302 + TInt styleCount=Count();
1.303 + for (TInt nn=0;nn<styleCount;nn++)
1.304 + delete (iList->At(nn)).iStyle;
1.305 + if (iList)
1.306 + iList->Reset();
1.307 +
1.308 + __TEST_INVARIANT;
1.309 + }
1.310 +
1.311 +
1.312 +void CStyleList::KillStyleList()
1.313 + {
1.314 + Reset();
1.315 + delete iList;
1.316 + }
1.317 +
1.318 +
1.319 +
1.320 +EXPORT_C TStreamId CStyleList::StoreL(CStreamStore& aStore)const
1.321 +/** Stores the style list to a stream store.
1.322 +
1.323 +@param aStore Stream store to which the style list is written.
1.324 +@return The ID of the stream store. */
1.325 + {
1.326 + __TEST_INVARIANT;
1.327 +
1.328 + RStoreWriteStream stream;
1.329 + TStreamId id=stream.CreateLC(aStore);
1.330 + //
1.331 + stream<< *this;
1.332 + //
1.333 + stream.CommitL();
1.334 + CleanupStack::PopAndDestroy();
1.335 + return id;
1.336 + }
1.337 +
1.338 +
1.339 +
1.340 +
1.341 +EXPORT_C void CStyleList::ExternalizeL(RWriteStream& aStream)const
1.342 +/** Externalises the style list to a write stream. The presence of this function
1.343 +means that the standard templated operator<<() (defined in s32strm.h) is available
1.344 +to externalise objects of this class. Does not externalise any styles' based-on
1.345 +links.
1.346 +
1.347 +@param aStream Stream to which the object should be externalised. */
1.348 + {
1.349 + __TEST_INVARIANT;
1.350 +
1.351 + TInt count=Count();
1.352 + aStream.WriteUint8L(count);
1.353 + for (TInt mm=0;mm<count;mm++)
1.354 + {
1.355 + CParagraphStyle* style=(iList->At(mm)).iStyle;
1.356 + style->ExternalizeL(aStream);
1.357 + }
1.358 + for (TInt nn=0;nn<count;nn++)
1.359 + {
1.360 + RParagraphStyleInfo set=iList->At(nn);
1.361 + CParagraphStyle* style=set.iStyle;
1.362 + TInt offset=(set.iStyleForNextPara!=NULL)
1.363 + ? IndexByPtr(style)
1.364 + : -1;
1.365 + if (!(offset==-1 || (offset>=0 && offset<Count())))
1.366 + {
1.367 + OstTrace0( TRACE_DUMP, CSTYLELIST_EXTERNALIZEL, "EStyleIntegrityError" );
1.368 + }
1.369 + __ASSERT_DEBUG(offset==-1 || (offset>=0 && offset<Count()),Panic(EStyleIntegrityError));
1.370 + aStream.WriteInt8L(offset);
1.371 + }
1.372 + }
1.373 +
1.374 +
1.375 +
1.376 +EXPORT_C void CStyleList::InternalizeL(RReadStream& aStream,
1.377 + const CParaFormatLayer* aGlobalParaFormatLayer,
1.378 + const CCharFormatLayer* aGlobalCharFormatLayer)
1.379 +/** Internalises the style list from a read stream. The presence of this function
1.380 +means that the standard templated operator>>() (defined in s32strm.h) is available
1.381 +to internalise objects of this class. Any existing style list contents are
1.382 +replaced.
1.383 +
1.384 +@param aStream Stream store from which the style list is internalised.
1.385 +@param aGlobalParaFormatLayer Pointer to the global paragraph format layer
1.386 +on which all styles in the list are based.
1.387 +@param aGlobalCharFormatLayer Pointer to the global character format layer
1.388 +on which all styles in the list are based. */
1.389 + {
1.390 + KillStyleList();
1.391 + TInt styleCount=aStream.ReadUint8L();
1.392 + ConstructL(Max(1,styleCount)); // panics if granularity==0
1.393 + RParagraphStyleInfo holdingSet;
1.394 + iList->AppendL(holdingSet,styleCount);
1.395 + for (TInt mm=0;mm<styleCount;mm++)
1.396 + {// restore the paragraph styles
1.397 + CParagraphStyle* style=CParagraphStyle::NewL(aStream,*aGlobalParaFormatLayer,*aGlobalCharFormatLayer);
1.398 + iList->At(mm).iStyle=style;
1.399 + }
1.400 + for (TInt nn=0;nn<styleCount;nn++)
1.401 + {// restore the "style for next paragraph" for each paragraph
1.402 + TInt offset=aStream.ReadInt8L();
1.403 + iList->At(nn).iStyleForNextPara=(offset==-1)
1.404 + ? NULL
1.405 + : iList->At(offset).iStyle;
1.406 + }
1.407 +
1.408 + __TEST_INVARIANT;
1.409 + }
1.410 +
1.411 +
1.412 +
1.413 +EXPORT_C TInt CStyleList::AppendL(RParagraphStyleInfo* aStyleSet)
1.414 +/** Appends a style to the style list. The list takes ownership of the style.
1.415 +
1.416 +@param aStyleSet The style (and optional style for the following paragraph)
1.417 +to append to the list.
1.418 +@return KErrNone if successful, or KErrAlreadyExists if the style is already
1.419 +present in the list. */
1.420 + {
1.421 + __TEST_INVARIANT;
1.422 +
1.423 + TInt count=Count();
1.424 + for (TInt ii=0;ii<count;ii++)
1.425 + {
1.426 + if (aStyleSet->iStyle==iList->At(ii).iStyle)
1.427 + return KErrAlreadyExists; // we already own this style
1.428 + }
1.429 + CleanupStack::PushL(aStyleSet->iStyle);
1.430 + iList->AppendL(*aStyleSet); // if the append fails, we must take responsibility for the style
1.431 + CleanupStack::Pop(); // aStyleSet.iStyle
1.432 +
1.433 + __TEST_INVARIANT;
1.434 + return KErrNone;
1.435 + }
1.436 +
1.437 +
1.438 +EXPORT_C void CStyleList::Remove(CParagraphStyle* aStyle)
1.439 +/** Removes a style from the style list. If the style is owned by the list, it
1.440 +is deleted. If the style is not owned by the list, but is referenced by a
1.441 +style owned by the list, (i.e. a style in the list is based on it, or references
1.442 +it as its iStyleForNextPara pointer) then the pointer to aStyle is set to
1.443 +NULL.
1.444 +
1.445 +@param aStyle Pointer to the style to remove from the style list, or to set
1.446 +to NULL. */
1.447 + {
1.448 + __TEST_INVARIANT;
1.449 +
1.450 + TInt styles = Count();
1.451 + TInt index = -1;
1.452 + for (TInt i = 0; i < styles; i++)
1.453 + {
1.454 + RParagraphStyleInfo& cur_style = (*iList)[i];
1.455 + if (cur_style.iStyleForNextPara == aStyle)
1.456 + cur_style.iStyleForNextPara = NULL;
1.457 + if (cur_style.iStyle->iBasedOn == aStyle)
1.458 + cur_style.iStyle->iBasedOn = NULL;
1.459 + if (cur_style.iStyle == aStyle)
1.460 + {
1.461 + // Assert that the style must occur only once in the style list.
1.462 + if (index != -1)
1.463 + {
1.464 + OstTrace0( TRACE_DUMP, CSTYLELIST_REMOVE, "EStyleIntegrityError" );
1.465 + }
1.466 + __ASSERT_DEBUG(index == -1,Panic(EStyleIntegrityError));
1.467 + index = i;
1.468 + }
1.469 + }
1.470 +
1.471 + if (index != -1)
1.472 + {
1.473 + delete aStyle;
1.474 + iList->Delete(index);
1.475 + }
1.476 +
1.477 + __TEST_INVARIANT;
1.478 + }
1.479 +
1.480 +
1.481 +
1.482 +EXPORT_C TInt CStyleList::SetStyleToFollow(const RParagraphStyleInfo& aStyleSet)
1.483 +/** Sets the style to use for the following paragraph for a style in the style
1.484 +list. Both the style (aStyleSet.iStyle) and the style to set for the following
1.485 +paragraph (aStyleSet.iStyleForNextPara) must exist in the style list.
1.486 +
1.487 +The function first locates the style (aStyleSet.iStyle) in the list, then
1.488 +sets the style to use for the next paragraph to aStyleSet.iStyleForNextPara.
1.489 +
1.490 +If aStyleSet.iStyle does not exist in the style list, the function returns
1.491 +with KErrNotFound. If aStyleSet.iStyleForNextPara does not exist in the style
1.492 +list, a panic occurs.
1.493 +
1.494 +@param aStyleSet Identifies a style in the list, and a style to use for its
1.495 +following paragraph.
1.496 +@return KErrNone if successful, or KErrNotFound if the first style contained
1.497 +in the argument (aStyleSet.iStyle) is not in the style list. */
1.498 + {
1.499 + if (IndexByPtr(aStyleSet.iStyleForNextPara) == KErrNotFound)
1.500 + {
1.501 + OstTrace0( TRACE_FATAL, CSTYLELIST_SETSTYLETOFOLLOW, "EStyleIntegrityError" );
1.502 + }
1.503 + __ASSERT_ALWAYS( IndexByPtr(aStyleSet.iStyleForNextPara) != KErrNotFound, Panic(EStyleIntegrityError) );
1.504 + __TEST_INVARIANT;
1.505 +
1.506 + TInt index = IndexByPtr(aStyleSet.iStyle);
1.507 + if (index == KErrNotFound)
1.508 + return index;
1.509 +
1.510 + (*iList)[index].iStyleForNextPara = aStyleSet.iStyleForNextPara;
1.511 +
1.512 + __TEST_INVARIANT;
1.513 +
1.514 + return KErrNone;
1.515 +
1.516 + }
1.517 +
1.518 +
1.519 +
1.520 +
1.521 +EXPORT_C RParagraphStyleInfo* CStyleList::PtrByName(const TParagraphStyleName& aName) const
1.522 +/** Gets the style with the specified name from the style list.
1.523 +
1.524 +@param aName The name of the style to retrieve.
1.525 +@return Pointer to the style with the name specified. NULL if there is no style
1.526 +with this name in the list. */
1.527 + {
1.528 + // Return a pointer to the named style if it's in the list, or null if not.
1.529 + __TEST_INVARIANT;
1.530 +
1.531 + int count = Count();
1.532 + for (int i = 0; i < count; i++)
1.533 + {
1.534 + RParagraphStyleInfo& style_info = (*iList)[i];
1.535 + if (style_info.iStyle != NULL && style_info.iStyle->iName == aName)
1.536 + return &style_info;
1.537 + }
1.538 + return NULL;
1.539 + }
1.540 +
1.541 +
1.542 +
1.543 +
1.544 +EXPORT_C RParagraphStyleInfo* CStyleList::PtrByType(const TUid aType) const
1.545 +/** Gets the style with the specified type UID from the style list.
1.546 +
1.547 +@param aType The UID of the style to retrieve.
1.548 +@return Pointer to the style with the type UID specified. NULL if there is
1.549 +no style with this type in the list. */
1.550 + {
1.551 + // Return a pointer to the first style with the specified type if any; or null if there are none with this type.
1.552 + __TEST_INVARIANT;
1.553 +
1.554 + int count = Count();
1.555 + for (int i = 0; i < count; i++)
1.556 + {
1.557 + RParagraphStyleInfo& style_info = (*iList)[i];
1.558 + if (style_info.iStyle != NULL && style_info.iStyle->Type() == aType)
1.559 + return &style_info;
1.560 + }
1.561 + return NULL;
1.562 + }
1.563 +
1.564 +
1.565 +
1.566 +
1.567 +EXPORT_C TInt CStyleList::IndexByPtr(const CParaFormatLayer* aPtr)const
1.568 +/** Gets the index into the style list of a specified paragraph style.
1.569 +
1.570 +@param aPtr Pointer to the style.
1.571 +@return The style's index into the style list. KErrNotFound if the style is
1.572 +not found in the style list, or if aPtr is a paragraph format layer rather
1.573 +than a style. */
1.574 + {
1.575 + if (aPtr->Type()==KNormalParagraphStyleUid)
1.576 + return KErrNotFound;
1.577 + TInt count=Count();
1.578 + if (count==0)
1.579 + return KErrNotFound; // ptr cannot be matched cos list is empty.
1.580 + TInt index=0;
1.581 + CParagraphStyle* style=NULL;
1.582 + while (index<count)
1.583 + {
1.584 + style=(*iList)[index].iStyle;
1.585 + if (style==aPtr)
1.586 + break;
1.587 + index++;
1.588 + }
1.589 + return (index<count)
1.590 + ? index
1.591 + : KErrNotFound;
1.592 + }
1.593 +
1.594 +
1.595 +
1.596 +
1.597 +EXPORT_C TInt CStyleList::IndexByName(const TDesC& aName)const
1.598 +/** Gets the index into the style list of a specified paragraph style, identified
1.599 +by its name.
1.600 +
1.601 +@param aName The name of the style.
1.602 +@return The style's index into the style list. KErrNotFound if the style name
1.603 +is not found in the style list. */
1.604 + {
1.605 + TInt count=Count();
1.606 + if (count==0)
1.607 + return KErrNotFound; // name cannot be in list cos its empty.
1.608 + TInt index=0;
1.609 + CParagraphStyle* style=NULL;
1.610 + while (index<count)
1.611 + {
1.612 + style=(*iList)[index].iStyle;
1.613 + if (style != NULL && style->iName == aName)
1.614 + break;
1.615 + index++;
1.616 + }
1.617 + return (index<count)
1.618 + ? index
1.619 + : KErrNotFound;
1.620 + }
1.621 +
1.622 +
1.623 +
1.624 +EXPORT_C CStyleList* CStyleList::DeepCloneL() const
1.625 +/** Creates and returns a style list which is a clone of the current style list.
1.626 +
1.627 +@return Pointer to a clone of the current style list. */
1.628 + {
1.629 + __TEST_INVARIANT;
1.630 +
1.631 + CStyleList* newList = CStyleList::NewL();
1.632 + CleanupStack::PushL(newList);
1.633 +
1.634 + TInt styleCount=Count();
1.635 + for (TInt styleItem=0;styleItem<styleCount;styleItem++)
1.636 + {
1.637 + const RParagraphStyleInfo& source=iList->At(styleItem);
1.638 + CParagraphStyle* style=source.iStyle->CloneL();
1.639 + RParagraphStyleInfo info(style,source.iStyleForNextPara);
1.640 + newList->AppendL(&info);
1.641 + }
1.642 +
1.643 + CleanupStack::Pop();
1.644 + return newList;
1.645 + }