UniTranslateDeadKey

UniTranslateDeadKey

UniTranslateDeadKey(kbHndl, vdKey, ucInChar, ucOutChar, newVDKey)

Translates a Unicode character and virtual/dead key into a composite character.

Parameters

kbHndl - KHAND - input

The keyboard handle created from UniCreateKeyboard.

vdKey - VDKEY - output

The virtual/dead key.

ucInChar - UniChar - input

The second character in the sequence.

ucOutChar - UniChar - output

The composite character.

newVDKey - VDKEY - output

The dead key value. For a non-zero value, the dead key is chained. OS/2 does not support chained dead keys.

Constants

None

Returns

An integer with values of:

• ULS_BADHANDLE
• ULS_NODEAD
• ULS_SUCCESS

Calling conversion

Cdecl32

Example Code

KHAND   kbHndl;
VDKEY   vdKey;
UniChar ucInChar;
UniChar  ucOutChar;
VDKEY   newVDKey;
integer rc;
...
rc = UniTranslateDeadKey(kbHndl, vdKey, ucInChar, ucOutChar, newVDKey);
...

Related Functions

• UniTranslateKey
• UniUntranslateKey

Notes

The calling program is expected to maintain the dead key state so that when the next dead key is found to form the full character. After the dead key translate, the dead key state needs to be reset.

There is a provision in the table for chained dead keys, which is used in Japanese logic. It shouldn't be used as OS/2 doesn't support chained dead keys.

OS Version Introduced

• OS/2 Warp