#include <mw/PtiKeyMappings.h>
| class MPtiKeyMappings |
| Public Member Functions | |
|---|---|
| virtual | ~MPtiKeyMappings() |
| pure virtual TPtiKey | CurrentKey() |
| pure virtual TPtrC | GetAll(TPtiTextCase) |
| pure virtual TPtiKey | KeyForCharacter(TUint16) |
| pure virtual TUint16 | NextKey(TPtiKey, TBool &, TPtiTextCase) |
| pure virtual TInt | ReplaceKeyMapL(TPtiKey, TDesC &, TPtiTextCase) |
| pure virtual TUint16 | StartMapping(TPtiKey, TPtiTextCase, TPtiEngineInputMode) |
| TPtiKey | CurrentKey | ( | ) | [pure virtual] |
Returns PtiEngine key code for last StartMapping() call.
Returns: PtiEngine key code for last StartMapping() call.
| TPtrC | GetAll | ( | TPtiTextCase | aCase | ) | [pure virtual] |
Returns all keymapping data for current key, excluding first character (which is expected to be "get all"-control character).
| Parameter | Description |
|---|---|
| aCase | Text case for which data will be returned. |
Returns: Constant descriptor pointing to keymap data.
| TUint16 | NextKey | ( | TPtiKey | aKey, |
| TBool & | aAppend, | |||
| TPtiTextCase | aCase | |||
| ) | [pure virtual] | |||
Continues keymapping sequence. This method should be called when key event comes in while multitapping timer is active. Takes care of cycling through multitapping candidates associated for given key.
| Parameter | Description |
|---|---|
| aKey | A key to be mapped. |
| aAppend | Refernce to boolen variable. This will be set to ETrue if current character in editor should be replaced (new multitapping candidate was found) and to EFalse if new character should inserted instead. |
| aCase | Text case for mapping operation. |
Returns: Next character assosiated to given key or the first character if aKey was different key than previous key press.
| TInt | ReplaceKeyMapL | ( | TPtiKey | aKey, |
| TDesC & | aMap, | |||
| TPtiTextCase | aCase | |||
| ) | [pure virtual] | |||
Replaces keymapping data for given key and case.
| Parameter | Description |
|---|---|
| aKey | A key to be replaced. |
| aMap | New keymapping data for aKey, |
| aCase | Text case for replaced data. |
Returns: KErrNone or system wide error code.
| TUint16 | StartMapping | ( | TPtiKey | aKey, |
| TPtiTextCase | aCase, | |||
| TPtiEngineInputMode | aMode = EPtiEngineInputModeNone | |||
| ) | [pure virtual] | |||
Starts mapping new key. Will return first character bound to given key in given text case.
| Parameter | Description |
|---|---|
| aKey | A key to be mapped. |
| aCase | Text case for mapping operation. |
| aMode | Input mode for mapping. This is needed if keymapping data contains characters for several input modes (used mainly with Chinese modes). This value will be matched to possible input mode control characters in keymapping data. |
Returns: First character bound to requested key.