// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "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:

// e32\include\k32keys.h

// 

// WARNING: This file contains some APIs which are internal and are subject

//          to change without notice. Such APIs should therefore not be used

//          outside the Kernel and Hardware Services package.

//

#ifndef __KEYSTD_H__

#define __KEYSTD_H__

////////////////////////////////////////////////////////

//

// Bits required for keyboard translation software

//

////////////////////////////////////////////////////////

#include <e32svr.h>

/**

@internalComponent

@released

*/

const TUint KConvTableSettableModifiers=EModifierAutorepeatable|

                                  EModifierKeypad|

                                  EModifierPureKeycode;

/**

@internalComponent

@released

*/

const TUint KPersistentModifiers=EModifierLeftAlt|

                           EModifierRightAlt|

						   EModifierAlt|

                           EModifierLeftCtrl|

						   EModifierRightCtrl|

                           EModifierCtrl|

						   EModifierLeftShift|

                           EModifierRightShift|

						   EModifierShift|

                           EModifierLeftFunc|

						   EModifierRightFunc|

                           EModifierFunc|

						   EModifierCapsLock|

                           EModifierNumLock|

						   EModifierScrollLock|

						   EModifierKeyboardExtend;

/**

@internalComponent

@released

*/

const TUint KRotationModifiers=EModifierRotateBy90|

						   EModifierRotateBy180|

						   EModifierRotateBy270;

/**

@publishedPartner

@released

*/

struct SScanCodeBlock

	{

	TUint16 firstScanCode;

	TUint16 lastScanCode;

	};

/**

@publishedPartner

@released

*/

struct SScanCodeBlockList

	{

	TUint numBlocks;

	const SScanCodeBlock *pblocks;

	};

/**

@publishedPartner

@released

*/

struct SConvSubTable

	{

	SScanCodeBlockList scanCodes;

	};

/**

@publishedPartner

@released

*/

struct SConvTableNode

	{

	TUint numSubTables;

	const SConvSubTable * const *ppsubTables;

	};

/**

@publishedPartner

@released

*/

struct SConvTable

	{

	TUint numNodes;

	const SConvTableNode *pnodes;

	};

/**

@publishedPartner

@released

*/

struct SKeyCodeList

	{

	TUint numKeyCodes;

	const TUint16 *pkeyCodes;

	};

/**

@publishedPartner

@released

*/

struct SFunc

	{

	TInt32 funcParam;

	TUint8 func;

	TUint8 filler;

	};

/**

@publishedPartner

@released

*/

struct SFuncAndState

	{

	};

/**

@publishedPartner

@released

*/

struct SFuncTableEntry

	{

	};

/**

@publishedPartner

@released

*/

struct SFuncTable

	{

	TUint numEntries;

	const SFuncTableEntry *pentries;

	};

/**

@publishedPartner

@released

*/

struct SFuncTables

	{

	SFuncTable defaultTable;

	SFuncTable modifierTable;

	TUint numGenFuncTables;

	const SFuncTable *pgenFuncTables;

	};

/**

@internalComponent

@released

*/

class TCharExtended: public TChar

	{

public:

	inline TCharExtended();

	inline TCharExtended(TUint aChar);

	TCharExtended &operator=(TUint aChar);

	TBool IsDigitGivenRadix(TRadix aRadix) const;

	TBool IsModifier() const;

	TInt DigitValue() const;

	TBool MatchesPattern(const TKeyCodePattern &aKeyCodePattern, TRadix aRadix=EDecimal) const;

	};

/**

@internalComponent

@released

*/

class TFuncTable

	{

public:

	TFuncTable();

	void Update(RLibrary aLibrary);

	SFunc GetModifierFunc(const TCharExtended &aChar, const TInt &aModifiers) const;

	SFuncAndState GetGeneralFuncAndState(const TCharExtended &aChar, const TInt &aModifiers,

															TUint aCurState, TRadix aRadix) const;

private:

	SFuncTables iFuncTables;

	SFuncTableEntry getDefault(const TCharExtended &aChar, const TInt &aModifiers) const;

	};

/**

@internalComponent

@released

*/

struct SConvKeyData

	{

	TInt modifiers;

	TUint16 keyCode;

	TUint16 filler;

	};

/**

@publishedPartner

@released

*/

enum TCtrlDigitsTermination

	{

	ETerminationByCount,

	ETerminationByCtrlUp

	};

/**

@internalComponent

@released

*/

class TConvTable

	{

public:

	TConvTable();

	void Update(RLibrary aLibrary);

	SConvKeyData Convert(TUint aScanCode, const TInt &aModifiers) const;

	SConvKeyData ConvertBaseCase(TUint aScanCode, const TInt &aModifiers) const;

	inline TUint FirstScanCode() const;

	inline TUint LastScanCode() const;

private:

	SConvTable iConvTable;

	TUint iFirstScanCode;

	TUint iLastScanCode;

	SScanCodeBlockList iKeypadScanCodes;

	SKeyCodeList iNonAutorepKeyCodes;

	TBool onKeypad(TUint aScanCode) const;

	TBool autorepeatable(TUint aKeyCode) const;

	};

/**

@internalComponent

@released

*/

class TCtrlDigits

	{

public:

	TCtrlDigits();

	void Update(RLibrary aLibrary);

	void Reset();

	void AppendDigit(TUint aKeyCode, TUint aModifiers);

	inline void SetRadix(TRadix aRadix);

	inline void SetMaxCount(TInt aMaxCount);

	inline TRadix GetRadix() const;

	TBool Terminated(TInt aModifiers) const;

	TUint SetStateToCtrlDigits() const;

	inline TBool WithinLimits() const;

	inline TUint GetDigits() const;

	inline TBool Error() const;

private:

	TInt iCount;

	TInt iMaxCount;

	TInt iMaximumCtrlDigitsMaxCount;

	TUint32 iDigits;

	TRadix iRadix;

	TBool iErrorFlag;

	TCtrlDigitsTermination iTermination;

	};

/**

@internalComponent

@released

*/

enum TState

	{

	EStateNormal						=0x0a,

	EStateCtrlDigitsUntilCount			=0x0b,

	EStateCtrlDigitsUntilCtrlUp			=0x0c,

// values used as "rules" to be processed in a switch statement

	EStateUnchanged						=0x40,

	EStateDerivedFromDigitEntered,

	EStateCtrlDigits

	};

/**

@internalComponent

@released

*/

enum TFuncGeneral

	{

	EDoNothing							=0x00,

	};

/**

@internalComponent

@released

*/

NONSHARABLE_CLASS(CKeyTranslatorX) : public CKeyTranslator

	{

    friend class CKeyTranslator;

public:

	CKeyTranslatorX();

    virtual TInt GetModifierState();

    virtual void SetModifierState(TEventModifier aModifier,TModifierState aState);

	virtual TBool TranslateKey(TUint aScanCode, TBool aKeyUp,

								const CCaptureKeys &aCaptureKeys, TKeyData &aKeyData);

    virtual void UpdateModifiers(TInt aModifiers);

    virtual TInt ChangeKeyData(const TDesC& aLibraryName);

    TBool currentlyUpperCase(void);

    TUint executeFunctionsAndSetState(TCharExtended aChar);

	TInt Initialise();

private:

    TInt iCurModifiers;

	TMaskedModifiers iTogglingModifiers;

	TCtrlDigits iCurCtrlDigits;

	TConvTable iConvTable;

	TFuncTable iFuncTable;

	TUint iCurState;

	TBool iIsdefaultKeyData;

	RLibrary iKeyDataLib;

	RLibrary iDefaultKeyDataLib;

	};

/**

@internalComponent

@released

*/

enum TCP850Char

	{

	ECP850LogicNot=0x00aa,

	ECP850LcAe=0x0091,

	ECP850LcCcedilla=0x0087,

	ECP850EsTset=0x00e1,

	ECP850LcOslash=0x009b,

	ECP850LcThorn=0x00d0,

	ECP850LcSoftTh=0x00e7,

	ECP850LeftChevron=0x00ae,

	ECP850RightChevron=0x00af,

	ECP850InvExclam=0x00ad,

	ECP850InvQuest=0x00a8,

	ECP850LcAo=0x0086,

	ECP850Pound=0x009c,

	ECP850LcAumlaut=0x0084,

	ECP850LcEumlaut=0x0089,

	ECP850LcIumlaut=0x008b,

	ECP850LcOumlaut=0x0094,

	ECP850LcUumlaut=0x009a,

	ECP850LcYumlaut=0x0098,

	ECP850SpaceUmlaut=0x00f9,

	ECP850LcAgrave=0x0085,

	ECP850LcEgrave=0x008a,

	ECP850LcIgrave=0x008d,

	ECP850LcOgrave=0x0095,

	ECP850LcUgrave=0x0097,

	ECP850SpaceGrave=0x0060,

	ECP850LcAacute=0x00a0,

	ECP850LcEacute=0x0082,

	ECP850LcIacute=0x00a1,

	ECP850LcOacute=0x00a2,

	ECP850LcUacute=0x00a3,

	ECP850LcYacute=0x00ec,

	ECP850LcSpaceAcute=0x0027,

	ECP850LcAtilde=0x00c6,