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-DF4C1226-E4D1-5701-BA55-8701754129D1" xml:lang="en"><title>Overriding

    13 the Charset when Reading Email Message Data</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>This tutorial explains how to override the charset when reading email message

    15 data. </p>

    16 <p>If the email message is stored in 8-bit format, the email application can

    17 retrieve the data stored using a new charset that is set by it. </p>

    18 <section><title>Procedure</title><p><b>Messages stored as rich text </b></p><p>For

    19 retrieving the message body text that has been stored in 8-bit and rich text

    20 format with a new character set using the <codeph>RestoreBodyTextL()</codeph> function,

    21 complete the following steps: </p><ol>

    22 <li id="GUID-F9F5EBB4-C09B-40F1-BAE4-20DB495044F5"><p>Use the <codeph>TMsvId aMessageId</codeph> parameter of the message

    23 body text to get the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> class. </p></li>

    24 <li id="GUID-E448097D-42F4-4C71-95A6-EC0A3B1AAFEE"><p>Use the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita#GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49/GUID-78A5A0B1-58D8-392B-90C2-6F68B92F0BD1"><apiname>CMsvEntry::ReadStoreL()</apiname></xref> method to get the <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref> class.</p></li>

    25 <li id="GUID-6B63A1C9-1BA5-458C-94F3-539FFDD35F3C"><p>Call the<xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita#GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE/GUID-8825B8E5-0285-3F0B-965D-D67F0F767D1B"><apiname>CMsvStore::RestoreBodyTextL()</apiname></xref> method that

    26 takes <codeph>CRichText&amp; aRichTextBody</codeph> and TUint aCharsetOverride<codeph/> parameters.</p></li>

    27 <li id="GUID-95BBBF38-739A-44FB-8FE2-B3E10DB57DF1"><p>Pass the new charset, with which to retrieve the body text as<codeph> TUint

    28 aCharsetOverride</codeph> parameter.</p></li>

    29 </ol><p><b>Messages stored as plain text</b></p><p>For retrieving the message

    30 body text that has been stored in 8-bit and plain text format with a new character

    31 set using the RestoreBodyTextL() function, complete the following steps:</p><ol>

    32 <li id="GUID-52D0EB1B-E07B-4199-AEE3-E97B426C7E13"><p>Use the <codeph>TMsvId aMessageId</codeph> parameter of the message

    33 body text to get the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref> class.</p></li>

    34 <li id="GUID-104D76F3-BACD-4B3A-97CD-F9EA83730297"><p>Use the <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita#GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49/GUID-78A5A0B1-58D8-392B-90C2-6F68B92F0BD1"><apiname>CMsvEntry::ReadStoreL()</apiname></xref> function to get

    35 the <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref> class. </p></li>

    36 <li id="GUID-E8FBD78C-D146-486D-8E29-C4B3BD2CB7D5"><p>Call the <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita#GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE/GUID-E07EE775-D4D0-37B7-8693-4EF4291BC648"><apiname>CMsvStore::InitialisePlainBodyTextForReadL()</apiname></xref> function

    37 to get the <xref href="GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F.dita"><apiname>CMsvPlainBodyText</apiname></xref> object.</p></li>

    38 <li id="GUID-6A86131B-98A8-427A-A94E-6594F44021B1"><p>Call the<xref href="GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F.dita#GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F/GUID-DC734608-1B80-3B1F-975A-FB0645A2880B"><apiname> CMsvPlainBodyText::SetCharacterSetL()</apiname></xref> function

    39 with the new charset ID with which to retrieve the body text.</p></li>

    40 <li id="GUID-21F46292-7A8D-4078-B5FB-47F2EE21EF00"><p>Call the <xref href="GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F.dita#GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F/GUID-7EE4AF2A-6DD6-399A-A9F6-6192107A9CA9"><apiname>CMsvPlainBodyText::NextChunkL()</apiname></xref> function

    41 or the <xref href="GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F.dita#GUID-6A4CAFB0-262A-3721-B91B-07F2C3B64B5F/GUID-623D0A28-59AD-37B4-A7C1-80A94BF3FDA3"><apiname>CMsvPlainBodyText::PreviousChunkL()</apiname></xref> function

    42 to get the body text in chunks.</p></li>

    43 </ol></section>

    44 </conbody><related-links>

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

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

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

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

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

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

    51 </related-links></concept>