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-4263CC05-EF13-5A2C-875C-72F3C2F6AB57" xml:lang="en"><title>Reading

    13 Email Messages Using the Rich Text API</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This tutorial explains how to read email messages using the rich text API. </p>

    15 

    16 <section><title>Introduction</title> <p>You can download and store email messages

    17 using any of the following interfaces, and read them using the <xref href="GUID-39945DA4-B362-3DF6-BF9E-DD079EEA7934.dita"><apiname>CRichText</apiname></xref> API. </p> <ul>

    18 <li id="GUID-924CB365-C6D7-5A06-AA8C-0B183F630149"><p> <xref href="GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F.dita"><apiname>CMsvPlainBodyText</apiname></xref>  </p> </li>

    19 <li id="GUID-102EC633-14C4-5CDE-B56A-E2F6800B928B"><p> <xref href="GUID-14EA98A8-06E7-33FF-B2B1-4BC3D044518D.dita"><apiname>CImPlainBodyText</apiname></xref>  </p> </li>

    20 <li id="GUID-27705FA3-83E7-5A41-8439-DD29CBBFA12E"><p> <xref href="GUID-39945DA4-B362-3DF6-BF9E-DD079EEA7934.dita"><apiname>CRichText</apiname></xref>  </p> </li>

    21 </ul> </section>

    22 <section><title>Procedure</title><p>To read an email message using the CRichText

    23 class, complete the following steps: </p><ol>

    24 <li id="GUID-EFDB277B-D0A7-42E8-B337-02CA737B4F72"><p>Use the <codeph>TMsvId aMessageId</codeph> parameter of the downloaded

    25 email to create the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> class. </p></li>

    26 <li id="GUID-94010CC4-603E-46DA-B691-355758A13C24"><p>Use the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> class to create the <xref href="GUID-323E701E-EA22-3CC8-AE84-C16880608D44.dita"><apiname>CImEmailMessage</apiname></xref> object

    27 class.</p></li>

    28 <li id="GUID-FFB38DCA-0805-454E-88F1-2B6505A16710"><p>Use the <xref href="GUID-323E701E-EA22-3CC8-AE84-C16880608D44.dita#GUID-323E701E-EA22-3CC8-AE84-C16880608D44/GUID-57CA3F50-33EA-359B-AABB-4E4E15AF2A18"><apiname>CImEmailMessage::GetBodyTextL()</apiname></xref> function

    29 to get the body text in the <xref href="GUID-39945DA4-B362-3DF6-BF9E-DD079EEA7934.dita"><apiname>CRichText</apiname></xref> class.</p></li>

    30 </ol></section>

    31 </conbody><related-links>

    32 <link href="GUID-2C8653F9-8873-59E8-9FD2-4215F6877ABC.dita"><linktext>Chunk Method

    33 to Process Emails</linktext></link>

    34 <link href="GUID-D73AD200-BE4D-50BF-BCF9-14627DE530B7.dita"><linktext>Imap4Example:

    35 An Email manager using IMAP4 and SMTP</linktext></link>

    36 <link href="GUID-BB35DBCC-FE56-547F-BADA-9EF854691ADC.dita"><linktext>Pop3Example:

    37 An Email manager using POP3 and SMTP</linktext></link>

    38 </related-links></concept>