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-F9F45DE7-6688-5C31-90F0-0BEA72E74034" xml:lang="en"><title>Creating

    13 Email Messages in Rich Text Format</title><shortdesc>This tutorial explains how to store the email message data in rich

    14 text format. Storing email messages in rich text format results in increased

    15 RAM storage space, when compared to storing messages in plain text format.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    16 <section><title>Procedure</title> <ol id="GUID-F7EF7462-A65E-50B0-BCDA-C915EB69DAAE">

    17 <li id="GUID-022C69C9-BFBF-5540-ABA1-DEAB836BCC26"><p>Create an email entry

    18 in the message store using <xref href="GUID-3F7DC1AB-D13C-31E9-967B-526AD72CD498.dita#GUID-3F7DC1AB-D13C-31E9-967B-526AD72CD498/GUID-FCDC47D2-0446-3CD7-A246-4DCED7C8A063"><apiname>CImEmailOperation::CreateNewL()</apiname></xref>,

    19 which takes all the following nine parameters. </p> <p><codeblock id="GUID-5BAB9612-275D-56C7-91B7-ED6D7AF93CA6" xml:space="preserve">static IMPORT_C CImEmailOperation *CreateNewL(TRequestStatus &amp;aObserverRequestStatus,

    20 CMsvSession &aMsvSession, TMsvId aDestination, TMsvId aSmtpServiceId,

    21 TMsvPartList aPartList, const TMsvEmailTypeList &aMsvEmailTypeList,

    22 TUid aMsgType, TInt aPriority, TBool aUsePlainTextStorage);</codeblock> </p> </li>

    23 <li id="GUID-83FDEF9F-DD2A-502B-9A80-3FBA28347261"><p>Set the <xref href="GUID-4B942C06-1BAC-3A21-B3B1-89FB5C51ADA0.dita"><apiname>TBool</apiname></xref> parameter

    24 to <codeph>EFalse</codeph>. </p> </li>

    25 <li id="GUID-DC8EEF57-35F8-5A28-83E7-7C98069C357C"><p>Use the <xref href="GUID-3F7DC1AB-D13C-31E9-967B-526AD72CD498.dita#GUID-3F7DC1AB-D13C-31E9-967B-526AD72CD498/GUID-38E7EABD-1300-3DF2-B9DF-B65EEABD8A31"><apiname>CImEmailOperation::ProgressL()</apiname></xref> function

    26 to obtain the <xref href="GUID-A4B1F874-27C0-3BB6-9D29-C35C75A5DB98.dita"><apiname>TMsvId</apiname></xref> parameter of the newly created email.

    27 This is returned through a <xref href="GUID-36B29964-420D-38D0-AF08-4DA70BED8B6E.dita"><apiname>TPckgC</apiname></xref> &lt;<xref href="GUID-A4B1F874-27C0-3BB6-9D29-C35C75A5DB98.dita"><apiname>TMsvId</apiname></xref> &gt;

    28 descriptor. </p> </li>

    29 <li id="GUID-16CDC45A-B8A6-5141-80A1-569182A2E642"><p>Create a <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> object

    30 using the <xref href="GUID-A4B1F874-27C0-3BB6-9D29-C35C75A5DB98.dita"><apiname>TMsvId</apiname></xref>  <codeph>aMessageId</codeph> parameter

    31 of the newly created email. </p> </li>

    32 <li id="GUID-FBDF917D-2265-524A-B574-500DC13F0095"><p>Use the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> object

    33 to the create a <xref href="GUID-323E701E-EA22-3CC8-AE84-C16880608D44.dita"><apiname>CImEmailMessage</apiname></xref> object. </p> </li>

    34 <li id="GUID-F52E2F63-5A8C-566A-B1B9-7B7D3EBEB4FE"><p>Create the body text

    35 of the email and insert into a <xref href="GUID-39945DA4-B362-3DF6-BF9E-DD079EEA7934.dita"><apiname>CRichText</apiname></xref> object. </p> </li>

    36 <li id="GUID-D1E2F8C6-8DB8-564F-8F46-08AD7329BA99"><p>Call the <xref href="GUID-323E701E-EA22-3CC8-AE84-C16880608D44.dita#GUID-323E701E-EA22-3CC8-AE84-C16880608D44/GUID-791117B4-C946-3D43-AE1E-68DDC10F85A3"><apiname>CImEmailMessage::StoreBodyTextL()</apiname></xref> function

    37 and pass the <xref href="GUID-39945DA4-B362-3DF6-BF9E-DD079EEA7934.dita"><apiname>CRichText</apiname></xref> class that contains the body text

    38 of the message. </p> </li>

    39 </ol> </section>

    40 </conbody><related-links>

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

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

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

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

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

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

    47 </related-links></concept>