Symbian3/Examples/guid-6013a680-57f9-415b-8851-c4fa63356636/txtexamp_8h_source.html
changeset 6 43e37759235e
equal deleted inserted replaced
5:f345bda72bc4 6:43e37759235e
       
     1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
       
     2 <html xmlns="http://www.w3.org/1999/xhtml">
       
     3 <head>
       
     4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
       
     5 <title>TB9.2 Example Applications: examples/AppFramework/txtshell/txtexamp.h Source File</title>
       
     6 <link href="tabs.css" rel="stylesheet" type="text/css"/>
       
     7 <link href="doxygen.css" rel="stylesheet" type="text/css"/>
       
     8 </head>
       
     9 <body>
       
    10 <!-- Generated by Doxygen 1.6.2 -->
       
    11 <h1>examples/AppFramework/txtshell/txtexamp.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Copyright (c) 2000-2009 Nokia Corporation and/or its subsidiary(-ies).</span>
       
    12 <a name="l00002"></a>00002 <span class="comment">// All rights reserved.</span>
       
    13 <a name="l00003"></a>00003 <span class="comment">// This component and the accompanying materials are made available</span>
       
    14 <a name="l00004"></a>00004 <span class="comment">// under the terms of &quot;Eclipse Public License v1.0&quot;</span>
       
    15 <a name="l00005"></a>00005 <span class="comment">// which accompanies this distribution, and is available</span>
       
    16 <a name="l00006"></a>00006 <span class="comment">// at the URL &quot;http://www.eclipse.org/legal/epl-v10.html&quot;.</span>
       
    17 <a name="l00007"></a>00007 <span class="comment">//</span>
       
    18 <a name="l00008"></a>00008 <span class="comment">// Initial Contributors:</span>
       
    19 <a name="l00009"></a>00009 <span class="comment">// Nokia Corporation - initial contribution.</span>
       
    20 <a name="l00010"></a>00010 <span class="comment">//</span>
       
    21 <a name="l00011"></a>00011 <span class="comment">// Contributors:</span>
       
    22 <a name="l00012"></a>00012 <span class="comment">//</span>
       
    23 <a name="l00013"></a>00013 <span class="comment">// Description:</span>
       
    24 <a name="l00014"></a>00014 <span class="comment">//</span>
       
    25 <a name="l00015"></a>00015 
       
    26 <a name="l00016"></a>00016 <span class="preprocessor">#ifndef __TXTEXAMP_H</span>
       
    27 <a name="l00017"></a>00017 <span class="preprocessor"></span><span class="preprocessor">#define __TXTEXAMP_H</span>
       
    28 <a name="l00018"></a>00018 <span class="preprocessor"></span>
       
    29 <a name="l00019"></a>00019 <span class="preprocessor">#include &lt;coemain.h&gt;</span>
       
    30 <a name="l00020"></a>00020 <span class="preprocessor">#include &lt;coecntrl.h&gt;</span>
       
    31 <a name="l00021"></a>00021 <span class="preprocessor">#include &lt;s32file.h&gt;</span>
       
    32 <a name="l00022"></a>00022 <span class="preprocessor">#include &lt;txtglobl.h&gt;</span>
       
    33 <a name="l00023"></a>00023 <span class="preprocessor">#include &lt;frmtview.h&gt;</span>
       
    34 <a name="l00024"></a>00024 <span class="preprocessor">#include &lt;txtfmlyr.h&gt;</span>
       
    35 <a name="l00025"></a>00025 
       
    36 <a name="l00026"></a>00026 <span class="comment">//</span>
       
    37 <a name="l00027"></a>00027 <span class="comment">// class MGraphicsExampleObserver</span>
       
    38 <a name="l00028"></a>00028 <span class="comment">//</span>
       
    39 <a name="l00029"></a>00029 
       
    40 <a name="l00030"></a><a class="code" href="class_m_graphics_example_observer.html">00030</a> <span class="keyword">class </span><a class="code" href="class_m_graphics_example_observer.html">MGraphicsExampleObserver</a>
       
    41 <a name="l00031"></a>00031         <span class="comment">// Defines an interface that controls can call to inform the shell </span>
       
    42 <a name="l00032"></a>00032         <span class="comment">// that they have finished, or that the status message display needs </span>
       
    43 <a name="l00033"></a>00033         <span class="comment">// updating. It is implemented by CExampleShellContainer        </span>
       
    44 <a name="l00034"></a>00034         {
       
    45 <a name="l00035"></a>00035 <span class="keyword">public</span>:
       
    46 <a name="l00036"></a>00036         <span class="comment">// Notify user that example has finished</span>
       
    47 <a name="l00037"></a>00037         <span class="keyword">virtual</span> <span class="keywordtype">void</span> NotifyGraphicExampleFinished()=0;
       
    48 <a name="l00038"></a>00038         <span class="comment">// Notify user of the current status of the example</span>
       
    49 <a name="l00039"></a>00039         <span class="keyword">virtual</span> <span class="keywordtype">void</span> NotifyStatus(<span class="keyword">const</span> TDesC&amp; aMessage)=0;
       
    50 <a name="l00040"></a>00040         };
       
    51 <a name="l00041"></a>00041 
       
    52 <a name="l00042"></a>00042 <span class="comment">//</span>
       
    53 <a name="l00043"></a>00043 <span class="comment">// class CGraphicExampleControl</span>
       
    54 <a name="l00044"></a>00044 <span class="comment">//</span>
       
    55 <a name="l00045"></a>00045 
       
    56 <a name="l00046"></a>00046 <span class="comment">/*</span>
       
    57 <a name="l00047"></a>00047 <span class="comment">        Usage</span>
       
    58 <a name="l00048"></a>00048 <span class="comment"></span>
       
    59 <a name="l00049"></a>00049 <span class="comment">                This class is used as a base class for graphics and text </span>
       
    60 <a name="l00050"></a>00050 <span class="comment">                examples. It uses CONE&#39;s facilities to provide an initialized </span>
       
    61 <a name="l00051"></a>00051 <span class="comment">                graphics environment.</span>
       
    62 <a name="l00052"></a>00052 <span class="comment"></span>
       
    63 <a name="l00053"></a>00053 <span class="comment">                It creates a 600x200 window in which drawing can be done.</span>
       
    64 <a name="l00054"></a>00054 <span class="comment"></span>
       
    65 <a name="l00055"></a>00055 <span class="comment">                It supports multiple phases, so different drawings can be </span>
       
    66 <a name="l00056"></a>00056 <span class="comment">                done from one phase to another.  Tap the spacebar or click the</span>
       
    67 <a name="l00057"></a>00057 <span class="comment">                mouse (anywhere) to advance a phase.</span>
       
    68 <a name="l00058"></a>00058 <span class="comment"></span>
       
    69 <a name="l00059"></a>00059 <span class="comment">                Quit the program by pressing the exit button.</span>
       
    70 <a name="l00060"></a>00060 <span class="comment"></span>
       
    71 <a name="l00061"></a>00061 <span class="comment">        Writing derived classes</span>
       
    72 <a name="l00062"></a>00062 <span class="comment"></span>
       
    73 <a name="l00063"></a>00063 <span class="comment">                A minimal derived class should have a Draw() function</span>
       
    74 <a name="l00064"></a>00064 <span class="comment">                which puts a drawing onto the screen.</span>
       
    75 <a name="l00065"></a>00065 <span class="comment"></span>
       
    76 <a name="l00066"></a>00066 <span class="comment">                If you are using multiple phases, code a constructor which</span>
       
    77 <a name="l00067"></a>00067 <span class="comment">                calls SetMaxPhases() specifying the number of phases.  Have</span>
       
    78 <a name="l00068"></a>00068 <span class="comment">                Draw() honour the phase number, available using Phase().</span>
       
    79 <a name="l00069"></a>00069 <span class="comment">*/</span>
       
    80 <a name="l00070"></a>00070 
       
    81 <a name="l00071"></a>00071 <span class="preprocessor">#pragma warning(disable : 4100)</span>
       
    82 <a name="l00072"></a>00072 <span class="preprocessor"></span>                <span class="comment">// disable &quot;parameter not used&quot; warning on HandleKey()</span>
       
    83 <a name="l00073"></a>00073 
       
    84 <a name="l00074"></a><a class="code" href="class_c_graphic_example_control.html">00074</a> <span class="keyword">class </span><a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a> : <span class="keyword">public</span> CCoeControl
       
    85 <a name="l00075"></a>00075         {
       
    86 <a name="l00076"></a>00076 <span class="keyword">public</span>:
       
    87 <a name="l00077"></a>00077         <span class="comment">// construct/destruct</span>
       
    88 <a name="l00078"></a>00078         <span class="keywordtype">void</span> ConstructL(<span class="keyword">const</span> TRect&amp; aRect, <a class="code" href="class_m_graphics_example_observer.html">MGraphicsExampleObserver</a>* aObserver, <span class="keyword">const</span> CCoeControl&amp; aParent);
       
    89 <a name="l00079"></a>00079                 <span class="comment">// second-phase construction</span>
       
    90 <a name="l00080"></a>00080         ~<a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a>();
       
    91 <a name="l00081"></a>00081         <span class="comment">// public so container can offer keys</span>
       
    92 <a name="l00082"></a>00082         TKeyResponse OfferKeyEventL(<span class="keyword">const</span> TKeyEvent&amp; aKeyEvent,TEventCode aType);
       
    93 <a name="l00083"></a>00083                 <span class="comment">// intercepts space; offers other keys to derived classes</span>
       
    94 <a name="l00084"></a>00084 <span class="keyword">protected</span>:
       
    95 <a name="l00085"></a>00085         <span class="comment">// derived classes must provide the next 2 functions</span>
       
    96 <a name="l00086"></a>00086         <span class="keyword">virtual</span> <span class="keywordtype">void</span> UpdateModelL() =0; <span class="comment">// empty update model function</span>
       
    97 <a name="l00087"></a>00087         <span class="keyword">virtual</span> <span class="keywordtype">void</span> Draw(<span class="keyword">const</span> TRect&amp; <span class="comment">/* aRect */</span>)<span class="keyword"> const </span>{}; <span class="comment">// empty draw function</span>
       
    98 <a name="l00088"></a>00088         <span class="comment">// use Phase() in Draw() to tell what phase we&#39;re in</span>
       
    99 <a name="l00089"></a>00089         TInt Phase()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> iPhase; }; <span class="comment">// get phase number</span>
       
   100 <a name="l00090"></a>00090         <span class="keywordtype">void</span> SetMaxPhases(TInt aMaxPhases) { iMaxPhases=aMaxPhases; };
       
   101 <a name="l00091"></a>00091                         <span class="comment">// use this from derived-class constructor to set number of phases</span>
       
   102 <a name="l00092"></a>00092         CFont* iMessageFont; <span class="comment">// font for messages</span>
       
   103 <a name="l00093"></a>00093 <span class="keyword">private</span>:
       
   104 <a name="l00094"></a>00094         <span class="comment">// functions provided for CCoeControl protocol</span>
       
   105 <a name="l00095"></a>00095         <span class="keywordtype">void</span> HandlePointerEventL(<span class="keyword">const</span> TPointerEvent&amp; aPointerEvent);
       
   106 <a name="l00096"></a>00096                 <span class="comment">// advances phase on pointer-down</span>
       
   107 <a name="l00097"></a>00097         <span class="keywordtype">void</span> Quit(); <span class="comment">// does termination</span>
       
   108 <a name="l00098"></a>00098         <span class="keywordtype">void</span> NextPhaseL(); <span class="comment">// advances phase: quits if all phases done</span>
       
   109 <a name="l00099"></a>00099         <span class="comment">// phase control for graphics examples</span>
       
   110 <a name="l00100"></a>00100         TInt iPhase; <span class="comment">// phase number</span>
       
   111 <a name="l00101"></a>00101         TInt iMaxPhases; <span class="comment">// maximum phases</span>
       
   112 <a name="l00102"></a>00102 <span class="keyword">protected</span>:
       
   113 <a name="l00103"></a>00103         <a class="code" href="class_m_graphics_example_observer.html">MGraphicsExampleObserver</a>* iFormObserver;
       
   114 <a name="l00104"></a>00104         TBool iUpdateModelDoesRedraw; <span class="comment">// whether UpdateModelL() does a redraw for us</span>
       
   115 <a name="l00105"></a>00105         };
       
   116 <a name="l00106"></a>00106 
       
   117 <a name="l00107"></a>00107 <span class="comment">// sundry derived classes</span>
       
   118 <a name="l00108"></a>00108 
       
   119 <a name="l00109"></a>00109 <span class="keyword">class </span>CGlobalText;
       
   120 <a name="l00110"></a>00110 <span class="keyword">class </span>CRichText;
       
   121 <a name="l00111"></a>00111 <span class="keyword">class </span>CParaFormatLayer;
       
   122 <a name="l00112"></a>00112 <span class="keyword">class </span>CCharFormatLayer;
       
   123 <a name="l00113"></a>00113 <span class="keyword">class </span>CTextLayout;
       
   124 <a name="l00114"></a>00114 <span class="keyword">class </span>CTextView;
       
   125 <a name="l00115"></a>00115 <span class="keyword">class </span>CStyleList;
       
   126 <a name="l00116"></a>00116 <span class="keyword">class </span>CParagraphStyle;
       
   127 <a name="l00117"></a>00117 
       
   128 <a name="l00118"></a>00118 
       
   129 <a name="l00119"></a><a class="code" href="class_c_global_control.html">00119</a> <span class="keyword">class </span><a class="code" href="class_c_global_control.html">CGlobalControl</a> : <span class="keyword">public</span> <a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a>
       
   130 <a name="l00120"></a>00120         {
       
   131 <a name="l00121"></a>00121         <span class="comment">// Demonstrates the use of global text</span>
       
   132 <a name="l00122"></a>00122 <span class="keyword">public</span>:
       
   133 <a name="l00123"></a>00123         <a class="code" href="class_c_global_control.html">CGlobalControl</a>() { SetMaxPhases(16); };
       
   134 <a name="l00124"></a>00124         <span class="keywordtype">void</span> UpdateModelL();
       
   135 <a name="l00125"></a>00125         <span class="keywordtype">void</span> Draw(<span class="keyword">const</span> TRect&amp; aRect) <span class="keyword">const</span>;
       
   136 <a name="l00126"></a>00126         ~<a class="code" href="class_c_global_control.html">CGlobalControl</a>();
       
   137 <a name="l00127"></a>00127 <span class="keyword">private</span>:
       
   138 <a name="l00128"></a>00128         CGlobalText* iGlobalText; <span class="comment">// global text object</span>
       
   139 <a name="l00129"></a>00129         CParaFormatLayer* iParaFormatLayer;
       
   140 <a name="l00130"></a>00130         CCharFormatLayer* iCharFormatLayer;
       
   141 <a name="l00131"></a>00131         TStreamId iStreamId; <span class="comment">// required when storing and restoring global text</span>
       
   142 <a name="l00132"></a>00132         <span class="comment">// text layout and view stuff</span>
       
   143 <a name="l00133"></a>00133         CTextLayout* iLayout; <span class="comment">// text layout</span>
       
   144 <a name="l00134"></a>00134         CTextView* iTextView; <span class="comment">// text view</span>
       
   145 <a name="l00135"></a>00135         TRect iViewRect; <span class="comment">// rectangle through which to view text</span>
       
   146 <a name="l00136"></a>00136         TCharFormat iCharFormat;
       
   147 <a name="l00137"></a>00137         TCharFormatMask iCharFormatMask;
       
   148 <a name="l00138"></a>00138         };
       
   149 <a name="l00139"></a>00139 
       
   150 <a name="l00140"></a><a class="code" href="class_c_rich_control.html">00140</a> <span class="keyword">class </span><a class="code" href="class_c_rich_control.html">CRichControl</a> : <span class="keyword">public</span> <a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a>
       
   151 <a name="l00141"></a>00141         {
       
   152 <a name="l00142"></a>00142         <span class="comment">// Demonstrates the use of rich text</span>
       
   153 <a name="l00143"></a>00143 <span class="keyword">public</span>:
       
   154 <a name="l00144"></a>00144         <a class="code" href="class_c_rich_control.html">CRichControl</a>() { SetMaxPhases(14);}; 
       
   155 <a name="l00145"></a>00145         ~<a class="code" href="class_c_rich_control.html">CRichControl</a>(); <span class="comment">// destructor</span>
       
   156 <a name="l00146"></a>00146         <span class="keywordtype">void</span> UpdateModelL();
       
   157 <a name="l00147"></a>00147         <span class="keywordtype">void</span> Draw(<span class="keyword">const</span> TRect&amp; aRect) <span class="keyword">const</span>;
       
   158 <a name="l00148"></a>00148 <span class="keyword">private</span>:
       
   159 <a name="l00149"></a>00149         CRichText* iRichText; <span class="comment">// global text object</span>
       
   160 <a name="l00150"></a>00150         CParaFormatLayer* iParaFormatLayer;
       
   161 <a name="l00151"></a>00151         CCharFormatLayer* iCharFormatLayer;
       
   162 <a name="l00152"></a>00152         TStreamId iStreamId; <span class="comment">// required when storing and restoring global text</span>
       
   163 <a name="l00153"></a>00153         <span class="comment">// text layout and view stuff</span>
       
   164 <a name="l00154"></a>00154         CTextLayout* iLayout; <span class="comment">// text layout</span>
       
   165 <a name="l00155"></a>00155         CTextView* iTextView; <span class="comment">// text view</span>
       
   166 <a name="l00156"></a>00156         TRect iViewRect; <span class="comment">// rectangle through which to view text</span>
       
   167 <a name="l00157"></a>00157         TCharFormat iCharFormat;
       
   168 <a name="l00158"></a>00158         TCharFormatMask iCharFormatMask;
       
   169 <a name="l00159"></a>00159         };
       
   170 <a name="l00160"></a>00160 
       
   171 <a name="l00161"></a><a class="code" href="class_c_style_control.html">00161</a> <span class="keyword">class </span><a class="code" href="class_c_style_control.html">CStyleControl</a> : <span class="keyword">public</span> <a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a>
       
   172 <a name="l00162"></a>00162         {
       
   173 <a name="l00163"></a>00163         <span class="comment">// Demonstrates the use of styles in rich text</span>
       
   174 <a name="l00164"></a>00164 <span class="keyword">public</span>:
       
   175 <a name="l00165"></a>00165         <a class="code" href="class_c_style_control.html">CStyleControl</a>() { SetMaxPhases(9);}; 
       
   176 <a name="l00166"></a>00166         ~<a class="code" href="class_c_style_control.html">CStyleControl</a>(); <span class="comment">// destructor</span>
       
   177 <a name="l00167"></a>00167         <span class="keywordtype">void</span> UpdateModelL();
       
   178 <a name="l00168"></a>00168         <span class="keywordtype">void</span> Draw(<span class="keyword">const</span> TRect&amp; aRect) <span class="keyword">const</span>;
       
   179 <a name="l00169"></a>00169 <span class="keyword">private</span>:
       
   180 <a name="l00170"></a>00170         <span class="keywordtype">void</span> CreateNormalL(); <span class="comment">// Create Normal style (the global layers) </span>
       
   181 <a name="l00171"></a>00171         <span class="keywordtype">void</span> CreateStylesL(); <span class="comment">// Create some paragraph styles</span>
       
   182 <a name="l00172"></a>00172 <span class="keyword">private</span>:
       
   183 <a name="l00173"></a>00173         CRichText* iRichText; <span class="comment">// rich text object</span>
       
   184 <a name="l00174"></a>00174         CParaFormatLayer* iNormalParaFormatLayer;
       
   185 <a name="l00175"></a>00175         CCharFormatLayer* iNormalCharFormatLayer;
       
   186 <a name="l00176"></a>00176         TStreamId iStreamId; <span class="comment">// required when storing and restoring global text</span>
       
   187 <a name="l00177"></a>00177         <span class="comment">// text layout and view stuff</span>
       
   188 <a name="l00178"></a>00178         CTextLayout* iLayout; <span class="comment">// text layout</span>
       
   189 <a name="l00179"></a>00179         CTextView* iTextView; <span class="comment">// text view</span>
       
   190 <a name="l00180"></a>00180         TRect iViewRect; <span class="comment">// rectangle through which to view text</span>
       
   191 <a name="l00181"></a>00181         CStyleList* iStyleList; <span class="comment">// Style list holds the two styles</span>
       
   192 <a name="l00182"></a>00182         CParagraphStyle* iStyleOne;
       
   193 <a name="l00183"></a>00183         CParagraphStyle* iStyleTwo;
       
   194 <a name="l00184"></a>00184         TCharFormat iCharFormat;
       
   195 <a name="l00185"></a>00185         TCharFormatMask iCharFormatMask;
       
   196 <a name="l00186"></a>00186         };
       
   197 <a name="l00187"></a>00187 
       
   198 <a name="l00188"></a><a class="code" href="class_c_view_control.html">00188</a> <span class="keyword">class </span><a class="code" href="class_c_view_control.html">CViewControl</a> : <span class="keyword">public</span> <a class="code" href="class_c_graphic_example_control.html">CGraphicExampleControl</a>
       
   199 <a name="l00189"></a>00189         {
       
   200 <a name="l00190"></a>00190         <span class="comment">// Demonstrates the use of the text view and text layout classes</span>
       
   201 <a name="l00191"></a>00191 <span class="keyword">public</span>:
       
   202 <a name="l00192"></a>00192         <a class="code" href="class_c_view_control.html">CViewControl</a>() { SetMaxPhases(14);}; 
       
   203 <a name="l00193"></a>00193         ~<a class="code" href="class_c_view_control.html">CViewControl</a>(); 
       
   204 <a name="l00194"></a>00194         <span class="keywordtype">void</span> UpdateModelL();
       
   205 <a name="l00195"></a>00195         <span class="keywordtype">void</span> Draw(<span class="keyword">const</span> TRect&amp; aRect) <span class="keyword">const</span>;
       
   206 <a name="l00196"></a>00196 <span class="keyword">private</span>:
       
   207 <a name="l00197"></a>00197         CRichText* iRichText; <span class="comment">// rich text object</span>
       
   208 <a name="l00198"></a>00198         CParaFormatLayer* iParaFormatLayer;
       
   209 <a name="l00199"></a>00199         CCharFormatLayer* iCharFormatLayer;
       
   210 <a name="l00200"></a>00200         <span class="comment">// text layout and view stuff</span>
       
   211 <a name="l00201"></a>00201         CTextLayout* iLayout; <span class="comment">// text layout</span>
       
   212 <a name="l00202"></a>00202         CTextView* iTextView; <span class="comment">// text view</span>
       
   213 <a name="l00203"></a>00203         TRect iViewRect; <span class="comment">// rectangle through which to view text</span>
       
   214 <a name="l00204"></a>00204         CFbsBitmap* iBitmap; <span class="comment">// line cursor bitmap</span>
       
   215 <a name="l00205"></a>00205         TCharFormat iCharFormat;
       
   216 <a name="l00206"></a>00206         TCharFormatMask iCharFormatMask;
       
   217 <a name="l00207"></a>00207         };
       
   218 <a name="l00208"></a>00208 
       
   219 <a name="l00209"></a>00209 <span class="preprocessor">#endif</span>
       
   220 <a name="l00210"></a>00210 <span class="preprocessor"></span>
       
   221 </pre></div></div>
       
   222 <hr size="1"/><address style="text-align: right;"><small>Generated by&nbsp;
       
   223 <a href="http://www.doxygen.org/index.html">
       
   224 <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
       
   225 </body>
       
   226 </html>