/*

 * Copyright (c) 2002 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:              

 *       Interface class providing information on available input languages

 *	    This header is exported

 *

 */

 #ifndef __AKNINPUTLANGUAGEINFO_H__

 #define __AKNINPUTLANGUAGEINFO_H__

 // INCLUDES

 #include <e32base.h>

 // For TBitFlags

 #include <eikdef.h>

 #include <bamdesca.h>

 #include <babitflags.h>

 // Typedefs

 typedef TBuf<32> TAknLanguageName;

 // CLASS DECLARATIONS

 /**

 * Input language capabilities

 *

 */

 class TAknInputLanguageCapabilities

 	{

     public:

 	    /**

 	    * These indices are used to set/clear capabilities.

 	    * Terms: 

 	    * - multitap refers to capability to enter alphabetic chars by pressing the same key repeatedly 

 	    * - predictive refers to the device matching (non-multitap) keypresses with potential words 

 	    *	in a dictionary. That is, what words would map to the current set of keypad presses

 	    * 

 	    * 

 	    */

 	    enum TAknInputLanguageCapabilityIndex

 	        {

 	        EMultitap =				0x00000000, 

 	        EPredictive =			0x00000001 

 	        };

 	    /**

 	    * C++ Constructor.  Initializes the internal state to "no capabilities"

 	    */

 	    IMPORT_C TAknInputLanguageCapabilities();

 	    /**

 	    * Sets the capability at a given index index to the logical value passed 

 	    *

 	    * @param aCapability	which capability to set

 	    * @param aSet			ETrue - enable the capability; EFalse - disable the capability

 	    */

 	    IMPORT_C void AssignCapability( TInt aCapabilityIndex, TBool aSet ); 

 	    /**

 	    * Tests a capability

 	    *

 	    * @param	aCapability		which capability to test

 	    * @return	EFalse if the capability is not present; not EFalse otherwise	

 	    */

 	    IMPORT_C TBool HasCapability( TInt aCapabilityIndex ) const;

 	    /**

 	    * Sets all capabilities (existing and potential)

 	    */

 	    IMPORT_C void SetAllCapabilities();

 	    IMPORT_C TAknInputLanguageCapabilities FilteredCapabilities( TAknInputLanguageCapabilities& aFilter) const;

 	    IMPORT_C TBool HasAnySupport() const;

     private:

 	    // Holds the internal state

 	    TBitFlags32	iCapabilities;	

 	};

 /**

 * Input Language Item class.

 * 

 * This object bring together Symbian language code, a language name, and its capabilities

 *

 * This method is not meant to be derived from.

 *

 */

 NONSHARABLE_CLASS(CAknInputLanguageItem) : public CBase

 	{

     public:

 	    /** 

 	    * static 2-stage construction of the object. The language name descriptor is copied 

 	    * by the time the method returns.

 	    *

 	    * Normally this is constructed by the class that supplies the language information.  It would 

 	    * not normally be called by clients who want to find out about system input languages

 	    *

 	    * @param	aLanguageCode	Symbian OS language code

 	    * @param	aName			Language name to be attached to code

 	    * @param	aCapabilities	Sets the capabilities

 	    * @return	Fully constructed input language item

 	    */

 	    static CAknInputLanguageItem* NewL( TLanguage aLanguageCode, const TDesC& aName, TAknInputLanguageCapabilities aCapabilities );

 	    /**

 	    * C++ destructor

 	    *

 	    */

 	    IMPORT_C ~CAknInputLanguageItem();

 	    IMPORT_C TLanguage LanguageCode() const;

 	    IMPORT_C TPtrC LanguageName() const;

 	    IMPORT_C TAknInputLanguageCapabilities Capabilities() const;

     private:

 	    /**

 	    * Sets only the langauge code

 	    */

 	    CAknInputLanguageItem( TLanguage aLanguageCode);

 	    /**

 	    * 2nd stage construction.  This sets the name and the capabilies

 	    */

 	    void ConstructL( const TDesC& aName, TAknInputLanguageCapabilities aCapabilities );

     private:

 	    TLanguage iLanguageCode;

 	    HBufC* iLanguageName;			// Owned

 	    TAknInputLanguageCapabilities	iCapabilities;

 	    TInt iSpare;					// for expansion

 	};

 /**

 *

 * Class to hold a list of CAknInputLanguageItem objects

 *

 */

 class CAknInputLanguageList : public CArrayPtrFlat<CAknInputLanguageItem>, public MDesCArray

     {

     public:

 	    /**

 	    * C++ Constructor 

 	    *

 	    */

 	    IMPORT_C CAknInputLanguageList(TInt aGranularity);

 	    /**

 	    * Destructor

 	    *

 	    */

 	    IMPORT_C ~CAknInputLanguageList();

     public: // from MDesCArray

 	    IMPORT_C TInt MdcaCount() const;

 	    IMPORT_C TPtrC MdcaPoint(TInt aIndex) const;

     };

 /**

 *

 * Input Language information interface.  This object is instantiated to create a standard interface

 * to the native input language services. 

 *

 */

 class CAknInputLanguageInfo : public CBase

 	{

     public:

 	    /**

 	    * This method returns the input capabilities of a language. The capability object can then 

 	    * be queried to see what it is capable of.

 	    *

 	    * @param	aLanguageId		Symbian language code

 	    * @return	a structure indicating what the language is capable of

 	    */

 	    virtual TAknInputLanguageCapabilities LanguageCapabilitiesFromLanguage(TLanguage aLanguageId) = 0;

 	    /**

 	    * Get the language name that corresponds to the passed-in Symbian OS language code.

 	    * This name should be localized, or not, depending upon the policy decided for the product

 	    * 

 	    * @param	aLanguageCode	- language code for the language whose name is required

 	    * @return	TAknLanguageName - buffer containing 

 	    */

 	    virtual TAknLanguageName LanguageName( TLanguage aLanguageCode ) const = 0;

 	    /**

 	    * Provide a language list corresponding to the input list of SymbianOS language codes.

 	    * The order of the languages in the output list is that order implemented in the 

 	    * interface object, and the order of the input list of language codes is ignored.

 	    *

 	    * @param aInputLanguageList Append to this list; 

 	    * @param aLanguageCodeList	Append only languages whose code is in this list. If Null is passed, then no language code filtering is done

 	    * @param aCapabilityFilter	Append only languages with capabilities set in this filter.

 	    *							If a filter with no capabilities whatsoever is passed, then all capabilities are included

 	    *

 	    */ 

 	    virtual void AppendLanguagesL( 

 		    CAknInputLanguageList* aInputLanguageList, 

 		    CArrayFix<TInt>* aLanguageCodeList,

 		    TAknInputLanguageCapabilities& aCapabilityFilter ) = 0;

 	    /**

 	    * Appends to an externally owned array of CAknInputLanguageItem-s. These can be interrogated to provide 

 	    * information upon return.

 	    *

 	    * @param aInputLanguageList		Passed-in array is appended to by this method

 	    */

 	    virtual void AppendAvailableLanguagesL( CAknInputLanguageList* aInputLanguageList ) = 0;

 	    /**

 	    * Return a langauge that is suitable in the product for a URL input language

 	    *

 	    * @return	TLanguage	A language code for the designated URL language

 	    */

 	    virtual TLanguage UrlLanguage() const = 0;

 	};

 /**

 * This factory class exists to supply an available input language interface 

 */

 class AknInputLanguageInfoFactory

 	{

     public:

 	    /**

 	    * Factory method to return a generic object from which information on available

 	    * languages can be obtained.

 	    *

 	    * @return a pointer to a fully constructed object conformant to CAknInputLanguageInfo 

 	    */

 	    IMPORT_C static CAknInputLanguageInfo* CreateInputLanguageInfoL();

 	};

 #endif // __AKNINPUTLANGUAGEINFO_H__

 // End of File