CPtiHalfQwertyKeyMappings Class Reference

Link against: ptiengine.lib


#include <
PtiKeyMappings.h>

Inherits CPtiKeyMappings.


Detailed Description

CPtiHalfQwertyKeyMappings.

Keymappings implementation class for half qwerty keyboard


Public Member Functions

IMPORT_C ~CPtiHalfQwertyKeyMappings ()
IMPORT_C TInt ReplaceKeyMapL (TPtiKey aKey, TDesC &aMap, TPtiTextCase aCase)
 Replaces keymapping data for given key.
IMPORT_C TPtiKey KeyForCharacter (TUint16 aChar)
 Scans through keymapping data and returns key code for given character.
IMPORT_C TPtrC GetAll (TPtiTextCase aCase)
 Returns all keymapping data for current key, excluding first character (which is expected to be "get all"-control character).
void GetNumericModeKeysFromDataL (RArray< TPtiNumericKeyBinding > &aResult)
 Fills given array with numeric mode mappings defined in keymap data file.
IMPORT_C void GetDataForKey (TPtiKey aKey, TDes &aResult, TPtiTextCase aCase)
 Returns keymapping data for given key.
IMPORT_C TUint16 StartMapping (TPtiKey aKey, TPtiTextCase aCase, TPtiEngineInputMode aMode=EPtiEngineInputModeNone)
 Starts mapping new key.
IMPORT_C TUint16 NextKey (TPtiKey aKey, TBool &aAppend, TPtiTextCase aCase)
 Continues keymapping sequence.

Static Public Member Functions

static IMPORT_C CPtiHalfQwertyKeyMappingsNewL (CPtiKeyMapData *aData)
 Constructor.

Protected Member Functions

TUint16 NextChar (TPtiTextCase aCase)

Constructor & Destructor Documentation

IMPORT_C CPtiHalfQwertyKeyMappings::~CPtiHalfQwertyKeyMappings  ) 
 

Member Function Documentation

IMPORT_C TPtrC CPtiHalfQwertyKeyMappings::GetAll TPtiTextCase  aCase  )  [virtual]
 

Returns all keymapping data for current key, excluding first character (which is expected to be "get all"-control character).

Parameters:
aCase Text case for which data will be returned.
Returns:
Constant descriptor pointing to keymap data.
Since:
S60 V3.0

Reimplemented from CPtiKeyMappings.

IMPORT_C void CPtiHalfQwertyKeyMappings::GetDataForKey TPtiKey  aKey,
TDes &  aResult,
TPtiTextCase  aCase
 

Returns keymapping data for given key.

Since:
S60 V5.0
Parameters:
aKey A key to be queried.
aResult Descritor where resulting data is stored.
aCase Text case

Reimplemented from CPtiKeyMappings.

void CPtiHalfQwertyKeyMappings::GetNumericModeKeysFromDataL RArray< TPtiNumericKeyBinding > &  aResult  ) 
 

Fills given array with numeric mode mappings defined in keymap data file.

Resultin array contains those mappings that are given with "numeric_mode_key" tag in keymap data file.

Since:
S60 V5.0
Parameters:
aResult An array to be filled with numeric mode mappings.
IMPORT_C TPtiKey CPtiHalfQwertyKeyMappings::KeyForCharacter TUint16  aChar  )  [virtual]
 

Scans through keymapping data and returns key code for given character.

Parameters:
aChar A character to be queried.
Returns:
Key code for mtaching key. EPtiKeyNone if no matching keys found.

Reimplemented from CPtiKeyMappings.

static IMPORT_C CPtiHalfQwertyKeyMappings* CPtiHalfQwertyKeyMappings::NewL CPtiKeyMapData *  aData  )  [static]
 

Constructor.

Reimplemented from CPtiKeyMappings.

TUint16 CPtiHalfQwertyKeyMappings::NextChar TPtiTextCase  aCase  )  [protected]
 

Reimplemented from CPtiKeyMappings.

IMPORT_C TUint16 CPtiHalfQwertyKeyMappings::NextKey TPtiKey  aKey,
TBool &  aAppend,
TPtiTextCase  aCase
[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.

Since:
S60 V5.0
Parameters:
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 chr-case character 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.

Reimplemented from CPtiKeyMappings.

IMPORT_C TInt CPtiHalfQwertyKeyMappings::ReplaceKeyMapL TPtiKey  aKey,
TDesC &  aMap,
TPtiTextCase  aCase
[virtual]
 

Replaces keymapping data for given key.

Parameters:
aKey Key code for key to be replaced.
aMap New keymapping data for aKey.
aCase Text case.
Returns:
KErrNone if succesfull Otherwise system wide error code.

Reimplemented from CPtiKeyMappings.

IMPORT_C TUint16 CPtiHalfQwertyKeyMappings::StartMapping TPtiKey  aKey,
TPtiTextCase  aCase,
TPtiEngineInputMode  aMode = EPtiEngineInputModeNone
[virtual]
 

Starts mapping new key.

Will return first character bound to given key in given text case.

Parameters:
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.

Reimplemented from CPtiKeyMappings.


The documentation for this class was generated from the following file:

Copyright © Nokia Corporation 2001-2007
Back to top