textandloc_pub/character_conversion_api/inc/CONVNAMES.H
author William Roberts <williamr@symbian.org>
Fri, 28 May 2010 14:59:04 +0100
branchRCL_3
changeset 29 8d17ed1e2513
parent 0 1fb32624e06b
child 16 56cd22a7a1cb
permissions -rw-r--r--
Re-merge fix for bug 1543

/*
* Copyright (c) 2000 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(__CONVNAMES_H__)
#define __CONVNAMES_H__

#if !defined(__E32STD_H__)
#include <e32std.h>
#endif

#if !defined(__E32BASE_H__)
#include <e32base.h>
#endif

#if !defined(__BAMDESCA_H__)
#include <bamdesca.h>
#endif 

#if !defined(__CHARCONV_H__)
#include <charconv.h>
#endif

class RFs;
class CBaNamedPlugins;

 
class CCnvCharacterSetNames : public CBase, public MDesCArray
/** 
A localised list of the names of non-Unicode character set encodings supported 
on the phone.

For each character conversion plug-in DLL, there are one or more resource 
files which contain the name of the encoding translated into a different language.

This class populates a list of the names of all encodings supported on the 
phone by reading the appropriate resource file for each one. The list is sorted 
according to the collation rules for the device's current locale.

The virtual functions MdcaCount() (returns the number of items in the list) 
and MdcaPoint() (returns a TPtrC for the item at the given index) are implemented 
privately in this class. Users of this class can call them through the MDesCArray 
interface. 
@publishedAll
@released
*/
	{
public:
	IMPORT_C static CCnvCharacterSetNames* NewL(RFs& aFileServerSession, const TArray<CCnvCharacterSetConverter::SCharacterSet>& aArrayOfCharacterSetsAvailable);
	IMPORT_C static CCnvCharacterSetNames* NewLC(RFs& aFileServerSession, const TArray<CCnvCharacterSetConverter::SCharacterSet>& aArrayOfCharacterSetsAvailable);
	IMPORT_C virtual ~CCnvCharacterSetNames();
	IMPORT_C TInt IndexOfIdentifier(TUint aIdentifier) const;
	IMPORT_C TUint IdentifierAtIndex(TInt aIndex) const;

private:
	CCnvCharacterSetNames();
	void ConstructL(RFs& aFileServerSession, const TArray<CCnvCharacterSetConverter::SCharacterSet>& aArrayOfCharacterSetsAvailable);
	// from MDesCArray
	virtual TInt MdcaCount() const;
	virtual TPtrC MdcaPoint(TInt aIndex) const;
	static void DestroyResourceFileArray(TAny* aArrayOfCharconvResourceFiles);

private:
	CBaNamedPlugins* iNamedPlugins;
	};

#endif