--- a/epoc32/include/miutconv.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/miutconv.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,206 @@
-miutconv.h
+// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __MIUTCONV_H__
+#define __MIUTCONV_H__
+
+#include <e32base.h>
+
+
+#if !defined (__CHARCONV_H_)
+#include <charconv.h>
+#endif
+
+#if !defined (__MIUTHDR_H__)
+#include <miuthdr.h>
+#endif
+
+#if !defined (__UTF_H_)
+#include <utf.h>
+#endif
+
+// IMail-specific stream type within an IMail file store for TImEmailTransformingInfo
+//
+const TUint KUidMsvCharsetNone = {0x10003C7F}; // 268450943
+const TUid KUidMsgFileTransformingInfo = {0x100094A5}; // 268473509
+const TUid KUidMsgEmailGeneralCenRep = {0x10285A25}; // 271079973
+
+// No longer used as the charset information retrieved from resource file.
+// Might possibly needed in the future ? maybe
+// const TUid KUidMiutSystemDefaultCharset = {0x10009418}; // 268473368
+// const TUid KUidMiutOverrideCharset = {0x10009419}; // 268473369
+
+_LIT8(KMiutUndisplayableChar, "?");
+
+/** SMTP send methods.
+@publishedAll
+@released
+*/
+enum TImSendMethod
+ {
+ /** Simple email. */
+ ESendAsSimpleEmail,
+ /** MIME email. */
+ ESendAsMimeEmail
+ };
+
+
+// Information to be used when sending an email message.
+// Relating to how parts are encoded and converted.
+//
+class TImEmailTransformingInfo
+/** Encapsulates character conversion and encoding settings for sending SMTP email.
+
+The default outcomes for header, body, HTML, and attachment parts respectively
+for each of the listed categories are given below:
+
+Plain Charset: ISO-8859-1,ISO-8859-1,N/A,N/A
+
+Plain Encoding:None,None,N/A,UU
+
+MIME Charset:UTF8,UTF8,UTF8*,N/A
+
+MIME Encoding:B,QP,Base64,Base64
+
+*: the UTF8 value set in the header field, but no conversion is done. The
+HTML converter converts to UTF8.
+@publishedAll
+@released
+*/
+ {
+public:
+ IMPORT_C TImEmailTransformingInfo& operator=(const TImEmailTransformingInfo& aInfo);
+ IMPORT_C TBool operator==(const TImEmailTransformingInfo& aInfo);
+
+ // streaming operations
+ IMPORT_C void ExternalizeL( RWriteStream& aWriteStream ) const;
+ IMPORT_C void InternalizeL( RReadStream& aReadStream );
+ IMPORT_C void StoreL( CMsvStore& aStore ) const;
+ IMPORT_C void RestoreL( CMsvStore& aStore );
+
+ // Setting functions
+ IMPORT_C void SetToDefault(const TImSendMethod aMethod);
+ IMPORT_C void SetSendMethod(const TImSendMethod aMethod);
+ IMPORT_C TImSendMethod SendMethod() const;
+
+ IMPORT_C void SetHeaderEncodingQ();
+ IMPORT_C void SetHeaderEncodingB();
+ IMPORT_C void SetBodyTextEncoding(TImEncodingType aType);
+ IMPORT_C void SetHTMLEncoding(TImEncodingType aType);
+ IMPORT_C void SetAttachmentEncoding(TImEncodingType aType);
+
+ IMPORT_C void SetHeaderAndBodyCharset(TUint aCharset);
+ IMPORT_C void SetHeaderCharset(TUint aCharset);
+ IMPORT_C void SetBodyTextCharset(TUint aCharset);
+ IMPORT_C void SetHTMLCharset(TUint aCharset);
+
+ // Accessor functions
+ IMPORT_C TImEncodingType HeaderEncoding() const;
+ IMPORT_C TImEncodingType BodyTextEncoding() const;
+ IMPORT_C TImEncodingType HTMLEncoding() const;
+ IMPORT_C TImEncodingType AttachmentEncoding() const;
+
+ IMPORT_C TUint HeaderCharset() const;
+ IMPORT_C TUint BodyTextCharset() const;
+ IMPORT_C TUint HTMLCharset() const;
+
+private:
+ void SetHeaderEncoding(TImEncodingType aType);
+
+private:
+ TImEncodingType iHeaderEncoding;
+ TImEncodingType iBodyEncoding;
+ TImEncodingType iHTMLEncoding;
+ TImEncodingType iAttachmentEncoding;
+
+ TUint iHeaderCharset;
+ TUint iBodyCharset;
+ TUint iHTMLCharset;
+ TUint iTextAttachmentCharset;
+
+ TImSendMethod iSendMethod;
+ };
+
+
+// Default Sending Charset/Encoding Values
+const TImEncodingType KDefaultMIMEHeaderEncoding = EEncodingTypeBASE64; // MIME
+const TImEncodingType KDefaultMIMEBodyTextEncoding = EEncodingTypeQP;
+const TImEncodingType KDefaultMIMEHTMLEncoding = EEncodingTypeBASE64;
+const TImEncodingType KDefaultMIMEAttachmentEncoding= EEncodingTypeBASE64;
+
+#define KDefaultPlainCharset KCharacterSetIdentifierIso88591
+
+const TImEncodingType KDefaultPlainHeaderEncoding = EEncodingTypeNone; // Non-MIME or Plain
+const TImEncodingType KDefaultPlainBodyTextEncoding = EEncodingTypeNone;
+const TImEncodingType KDefaultPlainAttachmentEncoding = EEncodingTypeUU;
+
+
+
+
+// Wrapper class for CHARCONV.
+// 'Our' charset dependant on build, UNICODE or CodePage 1252.
+//
+class CImConvertCharconv : public CBase
+/**
+@internalTechnology
+@released
+*/
+ {
+public:
+ IMPORT_C static CImConvertCharconv* NewL(CCnvCharacterSetConverter& aConverter, RFs& anFs);
+ ~CImConvertCharconv();
+
+ // MUST call prepare function first.
+ IMPORT_C TInt ConvertToOurCharsetL( const TDesC8& aBufIn, TDes& rBufOut,
+ TInt& rNumUnconvertedChars,
+ TInt& rIndexOfFirstUnconvertedChar);
+ IMPORT_C TInt ConvertFromOurCharsetL(const TDesC& aBufIn, TDes8& rBufOut,
+ TInt& rNumUnconvertedChars,
+ TInt& rIndexOfFirstUnconvertedChar);
+
+ // MUST be called prior to calling above two functions.
+ IMPORT_C TInt PrepareToConvertToFromOurCharsetL(const TUint aUid);
+
+ IMPORT_C TUint GetMimeCharsetUidL(const TDesC8& aBufIn) const;
+ IMPORT_C HBufC8* GetMimeCharsetTextStringL(const TUint& aUid) const;
+ IMPORT_C TUint DefaultCharset() const;
+ IMPORT_C TUint SystemDefaultCharset() const;
+
+ static TInt StraightCopy( const TDesC8& aBufIn, TDes& rBufOut);
+ static TInt StraightCopy( const TDesC& aBufIn, TDes8& rBufOut);
+private:
+ void ConstructL();
+ CImConvertCharconv(CCnvCharacterSetConverter& aConverter, RFs& anFs);
+ TBool CharsetAvailable(const TUint aUid);
+ void SetSystemDefaultCharsetL();
+
+ TInt GetSystemCharsetFromCenRepL(TDes8& aMimeCharSet);
+
+ enum TEmailGeneralSettingsCenRepId
+ {
+ EEmailGeneralCharSetId = 0x00000000
+ };
+
+private:
+ CCnvCharacterSetConverter& iConverter;
+ CArrayFix<CCnvCharacterSetConverter::SCharacterSet>* iCharsetsAvailable;
+
+ RFs& iFs;
+ TUint iCharsetUid;
+ TUint iSystemDefaultCharset; // Value obtained from .ini file
+ TInt iCharconvState;
+ };
+
+#endif