1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-70B9796F-8CF3-5DC4-93B4-0B1FED936169" xml:lang="en"><title>UI

    13 Data MTM implementation</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p> <b>Note:</b> This example is designed to work with Techview and there

    15 is no guarantee that it will work on other interfaces </p>

    16 <p>The <filepath>txti</filepath> project demonstrates a UI Data MTM. The central

    17 class is <codeph>CTxtiMtmUiData</codeph>, derived from the User Interface

    18 MTM base class <codeph>CBaseMtmUiData</codeph>. </p>

    19 <p> <filepath>txti</filepath> implements the following MTM functionality: </p>

    20 <section><title>Example Code</title> <p>Click on the following link to download

    21 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-419758e4-b663-48d3-bf21-d9c4bb00da23.zip" scope="external">TextMTM.zip</xref>  </p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-419758e4-b663-48d3-bf21-d9c4bb00da23.html" scope="peer">browse</xref> to view the example code. </p> <p>The

    22 files reproduced here are the main files contained in the examples directory.

    23 Some extra files may be needed to run the examples, and these will be found

    24 in the appropriate examples directory. </p> </section>

    25 <section><title>Class summary</title><p><xref href="GUID-899C6D87-5712-34A7-902C-EA452894700C.dita"><apiname>CBaseMtmUiData</apiname></xref></p></section>

    26 <section><title>Icons</title> <p>Icons are provided for messages, folders,

    27 and services, for use in the message browser. They are built into a Symbian

    28 OS multi-bitmap file <filepath>txti.mbm</filepath>. <codeph>ContextIcon()</codeph> selects

    29 the correct icon depending on the entry context. </p> </section>

    30 <section><title>MTM-specific operations</title> <p>Menu specifications for

    31 the two MTM-specific operations, Refresh and Export text to file, are provided

    32 in the resource <codeph>r_textud_function_array</codeph>. <codeph>OperationSupportedL()</codeph> determines

    33 whether these operations are appropriate to the entry context. </p> </section>

    34 <section><title>Context-specific information (Can&lt;Operation&gt; functions)</title> <p>Implementations

    35 of these functions check that that the specific operation is available and

    36 appropriate to the context. </p> </section>

    37 </conbody></concept>