1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/textandloc/textrendering/texthandling/testdata/COMPLEX.PML	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,48 @@
     1.4 +<G>
     1.5 +<P Alignment=center KeepTogether KeepWithNext>
     1.6 +<C Bold Underline FontHeight=400>Overview
     1.7 +<P Alignment=left SpaceAfter=250 !KeepWithNext>
     1.8 +<C FontHeight=200 !Bold !Underline>The EditableText class hierarchy provides
     1.9 + instantiable classes for editing and storing text.  The choice of which 
    1.10 + class to use depends on your requirements of text editing.
    1.11 +<P SpaceBefore=250 Alignment=Left Indent=1440 KeepWithNext>
    1.12 +<C Bold StrikeThrough FontHeight=350>Usage
    1.13 +<P Indent=0>
    1.14 +<C !Bold !Strikethrough FontHeight=200>
    1.15 +Two instantiable editable text classes are supplied:
    1.16 +<P Indent=700 SpaceBefore=240 SpaceAfter=240>
    1.17 +GlobalText
    1.18 +<P>
    1.19 +RichText
    1.20 +<P Indent=0>
    1.21 +and each case, there is a choice of physical implementation:
    1.22 +<P Indent=700>Flat storage
    1.23 +<P>Segemented storage.
    1.24 +<P Indent=0>Flat storage is most efficient when there is little text to be stored, or in the case where little or no editing will take place on the stored text.
    1.25 +<P>Segmented storage is most efficient where large quantities of text are to be stored, or where the text has a large dynamic content.
    1.26 +<P>The rich text class supports:
    1.27 +<P Indent=700>paragraph styles
    1.28 +<P>character styles
    1.29 +<P>explicit paragraph & character formatting
    1.30 +<P>embedded pictures etc... (See the spec).
    1.31 +<P Indent=0>In contrast, global text applies a<C Bold Italic> single <C !Bold !Italic>paragraph/character style to the entire contents of the document.
    1.32 +<P>Global text is best used for edit boxes, whereas rich text applications include the word processor and agenda entries, to name but two.
    1.33 +<P Alignment=right SpaceBefore=1440>
    1.34 +<C Bold Underline FontHeight=450>CEditableText Methods<C !Bold !Underline>
    1.35 +<P Alignment=justified SpaceBefore=240 SpaceAfter=300>
    1.36 +<C Bold>ConstructL                                                                                                Phase2 construction<C !Bold>
    1.37 +<P Alignment=left KeepWithNext KeepTogether>
    1.38 +<C Bold>void ConstructL(TDocumentStorage aStorage);<C !Bold>
    1.39 +<P !KeepWithNext !KeepTogether>
    1.40 +All calls to a document constructor must be followed by an explicit call to the<C Underline> ConstructL <C !Underline>method.  This method completes the 2 phase object construction favoured by Epoc.  The parameter<C Italic Underline> aStorage <C !Ita
    1.41 +lic !Underline>defines which implementation to use.  The type<C Underline> TDocumentStorage <C !Underline>is defined in<C Underline> EDITTEXT.H <C !Underline>as follows:
    1.42 +<P Alignment=center>
    1.43 +<C Bold>enum TDocumentStorage {EFlat,ESegmented};<C !Bold>
    1.44 +<P Alignment=justified>
    1.45 +This method may leave.  A complete example of document construction is provided below:
    1.46 +<P Indent=1460>
    1.47 +<C Bold>CEditableText* document=new(ELeave) CGlobalText;
    1.48 +<P>
    1.49 +document->ConstructL(ESegmented);  // Leaves if construction fails.<C !Bold>
    1.50 +<P Indent=0 Alignment=justified>
    1.51 +A mandatory part of the ConstructL method inserts an end-of-document character into the document.  This character is not included in the DocumentLength method.