// 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