filehandling/fileconverterfw/INC/CONCNF.H
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 02 Feb 2010 10:12:00 +0200
changeset 0 2e3d3ce01487
permissions -rw-r--r--
Revision: 201002 Kit: 201005

// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//

#if !defined(__CONCNF_H__)
#define __CONCNF_H__

#include <e32base.h>
#include <f32file.h>
#include <s32stor.h>
#include <apmstd.h>
#include <barsc.h>
#include <barsread.h>

/**
@publishedAll 
@released 
*/
#define KMaxTranslation 50

/** Buffer to contain a localised data type name. 

@publishedAll 
@released */
typedef TBuf<KMaxTranslation> TTranslation;


class TLanguageInfo
/** Holds a localised name for a data type. 

@publishedAll 
@released */
	{
public:
	TLanguageInfo();
	IMPORT_C TLanguageInfo(TLanguage aLanguage,TTranslation aTranslation);
public:
	void InternalizeL(RReadStream& aStream);
	void ExternalizeL(RWriteStream& aStream) const;
	TLanguage Language();
	TTranslation Translation();
	void ReadFromResource(TResourceReader& aReader);
public:
	TLanguage	iLanguage;
	TTranslation iTranslation;
	};

class CMimeInfo : public CBase
/** Holds the localised names for a data type.

@publishedAll
@released */
	{
public:
	IMPORT_C ~CMimeInfo();
	IMPORT_C static CMimeInfo* NewLC(TDataType& aMime);
	static CMimeInfo* NewL();
	static CMimeInfo* NewLC(const CMimeInfo* aInfo);
public:
	void InternalizeL(RReadStream& aStream);
	void ExternalizeL(RWriteStream& aStream) const;
	TDataType Mime();
	TTranslation Text();
	IMPORT_C void AddLanguageL(TLanguageInfo aLang);
	static CMimeInfo* NewLC(TResourceReader& aReader);
private:
	void ConstructL();
	void ConstructL(TResourceReader& aReader);
	void AddLanguageInfoL(TResourceReader& aReader);
private:
	TDataType iMime;
	CArrayFixFlat<TLanguageInfo> *iLanguageInfo;
	};

class CCnaConverter : public CBase
/** Holds the inherent properties of a converter. 

These are its UID and the data types it supports.

Note that the setter functions affect only the current object, not the stored 
information for the converter.

@publishedAll
@released */
	{
public:
	static CCnaConverter* NewLC();
	static CCnaConverter* NewL();
	IMPORT_C static CCnaConverter* NewL(TUid aUid);
	IMPORT_C static CCnaConverter* NewLC(TUid aUid);
	IMPORT_C static CCnaConverter* NewL(const CCnaConverter& aConverter);
	IMPORT_C static CCnaConverter* NewLC(const CCnaConverter& aConverter);
	IMPORT_C ~CCnaConverter();
	IMPORT_C void SetUid(TUid aUid);
	IMPORT_C TBool MimeFrom(const TDataType& aMimeType) const;
	IMPORT_C TBool MimeTo(const TDataType& aMimeType) const;
	IMPORT_C TTranslation MimeFromText(const TDataType& aMimeType) const;
	IMPORT_C TTranslation MimeToText(const TDataType& aMimeType) const;
	IMPORT_C TInt CountFrom() const;
	IMPORT_C TInt CountTo() const;
	IMPORT_C TDataType MimeFrom(TInt aIndex) const;
	IMPORT_C TDataType MimeTo(TInt aIndex) const;
	IMPORT_C TTranslation MimeFromText(TInt aIndex) const;
	IMPORT_C TTranslation MimeToText(TInt aIndex) const;
	inline TUid Uid() const;
	static CCnaConverter* NewL(TUid aUid,TResourceReader& aReader);	
private:
	CCnaConverter();
	void ConstructL();
	TBool FindMime(const TDataType& aMimeType, const CArrayPtrFlat<CMimeInfo>* aList) const;
	TTranslation FindMimeText(const TDataType& aMimeType, const CArrayPtrFlat<CMimeInfo>* aList) const;
	void ConstructL(TUid aUid,TResourceReader& aReader);
	void AddMimeDataL(TResourceReader& aReader, CArrayPtrFlat<CMimeInfo>& aMimeInfo);
private:
	TUid iUid;
	CArrayPtrFlat<CMimeInfo>* iMimeFrom;
	CArrayPtrFlat<CMimeInfo>* iMimeTo;
	};

inline TUid CCnaConverter::Uid() const
/** Gets the converter UID.

@return Converter UID */
	{return iUid;}

class CCnaConvInfoFile2 : public CBase
/**
implementation class
@internalComponent
*/
	{
public:
	~CCnaConvInfoFile2();
	//
protected:
	void ConstructL();
protected:
	RFs iFs;
	RResourceFile iResourceFile;
	CArrayPtr<CCnaConverter>* iConverters;
	};

/** Encapsulates a collection of converter properties (CCnaConverter) read from a converter 
information (.rsc) file.

@publishedAll
@released
*/
// Each RSC file contains CCnaConverter information for each
// available CConverterBase2 derived class in its associated DLL.

// In addition there may be INI files for each converter which supply run time extended
// CCnaConverter information such as additional mime types.
class CCnaConvInfoFileReader2 : public CCnaConvInfoFile2
	{
public:
	IMPORT_C static CCnaConvInfoFileReader2* NewLC(const TDesC& aFileName);
	IMPORT_C static CCnaConvInfoFileReader2* NewL(const TDesC& aFileName);
	IMPORT_C TInt Count();
	IMPORT_C CCnaConverter* AtL(TInt anIndex);
	//
	IMPORT_C void RestoreL();
private:
	CCnaConvInfoFileReader2();
	void RestoreConverterL(TResourceReader& aReader);
	void ConstructL(const TDesC& aFileName);
	};

#endif