MPtiKeyMapData Class Reference

class MPtiKeyMapData

Interface class for PtiEngine keymapping data. Keymapping data is built into ecom dlls and accessesed through this interface. PtiEngine clients do not normally need to use this class directly.

Member Functions Documentation

DataForKey(TPtiKeyboardType, TPtiKey, TPtiTextCase)

TPtrC DataForKey(TPtiKeyboardTypeaKeyboardType,
TPtiKeyaKey,
TPtiTextCaseaCase
)const [pure virtual]

Returns keymap data for given keyboard type, key and text case.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TPtiKey aKeyA key to be requested.
TPtiTextCase aCaseA text case for aKey

DataForKey(TPtiKeyboardType, TInt)

TPtrC DataForKey(TPtiKeyboardTypeaKeyboardType,
TIntaIndex
)const [pure virtual]

Returns keymap data for given keyboard type, key and text case. This version takes an internal keymap binding table index as a parameter. PtiEngine framework doesn't call this method directly. Normally the real implementation for this method is generated by keymap data builder into keymap plugin file, so each language data plugin has own implementation of this method.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt aIndexA internal index into keymap buildings table.

DeadKeyDataArray(TPtiKeyboardType, TInt &)

const TUint16 *DeadKeyDataArray(TPtiKeyboardTypeaKeyboardType,
TInt &aNumRowsInArray
)const [pure virtual]

Returns pointer to dead key data table.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt & aNumRowsInArrayThis integer is filled with number of rows in array.

DeadKeyDataForKey(TPtiKeyboardType, TPtiKey, TPtiTextCase)

TPtrC DeadKeyDataForKey(TPtiKeyboardTypeaKeyboardType,
TPtiKeyaKey,
TPtiTextCaseaCase
)const [pure virtual]

Returns dead key data for given key / case combination.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TPtiKey aKeyA key to be queried.
TPtiTextCase aCaseA text case for aKey.

GetNumericModeKeysL(TPtiKeyboardType, RArray< TPtiNumericKeyBinding > &)

voidGetNumericModeKeysL(TPtiKeyboardTypeaKeyboardType,
RArray< TPtiNumericKeyBinding > &aResult
)const [pure virtual]

This methods fills an array of key bindings with those keys that produce numeric mode characters for given keyboard type. This is needed because not all languages naturally contain required numeric mode characters. Text input framework needs to know which keys to use in that case. For example, user always needs to be able to produce characters 'p' and 'w' for phone number editor, but many languages (Arabic, Hebrew, etc) don't have those characters in their qwerty key mapping data. This method makes it possible to define in key mapping data file which keys will be used if a number mode character is missing from normal qwerty mappings.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
RArray< TPtiNumericKeyBinding > & aResultresulting key array will be stored here. Existing entries are cleared.

HasDeadKeys(TPtiKeyboardType)

TBool HasDeadKeys(TPtiKeyboardTypeaKeyboardType)const [pure virtual]

Returns a boolean value indicating whether key mapping data contains dead keys.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type

HasFnKeyBindings(TPtiKeyboardType)

TBool HasFnKeyBindings(TPtiKeyboardTypeaKeyboardType)const [pure virtual]

Returns boolean value indicating whether given keyboard data contains fn-key mappings.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type

HasKeyData(TPtiKeyboardType)

TBool HasKeyData(TPtiKeyboardTypeaKeyboardType)const [pure virtual]

Returns a boolean value indicating whether language dll contains keymapping data for given keyboard type.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type

HasVowelSequences(TPtiKeyboardType)

TBool HasVowelSequences(TPtiKeyboardTypeaKeyboardType)const [pure virtual]

Returns boolean value indicating whether keymapping data contains vowel sequences (such as those needed for Vietnamese qwerty input).

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type

IsDeadKey(TPtiKeyboardType, TPtiKey, TPtiTextCase)

TBool IsDeadKey(TPtiKeyboardTypeaKeyboardType,
TPtiKeyaKey,
TPtiTextCaseaCase
)const [pure virtual]

Returns a boolean value indicating whether given key / case combination is so called 'dead key'.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TPtiKey aKeyA key to be queried.
TPtiTextCase aCaseA text case for aKey

IsNumberModeKey(TPtiKeyboardType, TPtiNumericKeyBinding &)

TBool IsNumberModeKey(TPtiKeyboardTypeaKeyboardType,
TPtiNumericKeyBinding &aWhichKey
)const [pure virtual]

This methods takes the given TPtiNumericKeyBinding struct and fills its iChar field if iKey and iShifted parameters of that struct match to any of the qwerty number mode keys for this language.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TPtiNumericKeyBinding & aWhichKeyA structure containing search parameters and result field.

KeyBindingTable(TPtiKeyboardType, TInt &)

const TPtiKeyBinding *KeyBindingTable(TPtiKeyboardTypeaKeyboardType,
TInt &aNumItems
)const [pure virtual]

This method provides direct access to keybinding table. Normally this isn't needed outside of keymapping classes. Use only if none of the convinienece methods above is applicable

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt & aNumItemsThis integer will be filled with number of items in reurned table.

KeyData(TPtiKeyboardType, TInt &)

const TUint16 *KeyData(TPtiKeyboardTypeaKeyboardType,
TInt &aDataSize
)const [pure virtual]

This methods provides direct access to keymap data table. In most cases this method is not needed outside keymap data classes. Use only if none of the convinience methods above is applicable.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt & aDataSizeThis integer filled with number of TUint16 values in data table.

LanguageCode()

TInt LanguageCode()const [pure virtual]

Returns language code for keymap data.

Since
S60 V5.0

NumberOfKeys(TPtiKeyboardType)

TInt NumberOfKeys(TPtiKeyboardTypeaKeyboardType)const [pure virtual]

Returns maximum number of physical keys used for given keyboard type.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type.

NumericModeKeysTable(TPtiKeyboardType, TInt &)

const TPtiNumericKeyBinding *NumericModeKeysTable(TPtiKeyboardTypeaKeyboardType,
TInt &aNumEntries
)const [pure virtual]

Returns pointer to numeric mode key table for given keyboard type. Number of items in array is stored to given integer variable.

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt & aNumEntriesThe number of items in return array will be stored to this integer value.

Reserved_1()

voidReserved_1()[pure virtual]

Reserved vtable entries.

Reserved_2()

voidReserved_2()[pure virtual]

Reserved_3()

voidReserved_3()[pure virtual]

Reserved_4()

voidReserved_4()[pure virtual]

SuitableForLatinOnlyMode()

TBool SuitableForLatinOnlyMode()const [pure virtual]

This method returns a boolean value indicating whether this language can be used in "Latin Only" editors. If this method returns EFalse, then input framework will substitute it locally with English for "Latin Only" editors. Default implementation returns ETrue, so most languages don't need to define this in their key mapping data file.

Since
S60 V5.0

VowelSequenceTable(TPtiKeyboardType, TInt &)

const TVowelSequence *VowelSequenceTable(TPtiKeyboardTypeaKeyboardType,
TInt &aNumEntries
)const [pure virtual]

Returns pointer to vowel sequence table (needed for Vietnamese qwerty input).

Since
S60 V5.0

Parameters

TPtiKeyboardType aKeyboardTypeKeyboard type
TInt & aNumEntriesThis integer will be filled with number of entries in table.