UniUntranslateKey

Translates a Unicode character and virtual/dead key to a scan code to create the effective shift state.

Syntax

UniUntranslateKey(keyHndl, uc, vdkey, pmscan, efshift) ;

Parameters

keyHndl - KHAND - input

The keyboard handle as created by UniCreateKeyboard

uc - UniChar - input

Unicode character to be untranslated

vdkey - VDKEY - input

Virtual/dead key

pmscan - VSCAN - output

The Presentation Manager scan code

efshift - ULONG - output

Effective shift state to generate this character

Constants

None

Returns

An integer with values of:

• ULS_BADHANDLE
• ULS_NOSCAN
• ULS_SUCCESS

Calling Convention

Cdecl32

Example Code

KHAND   keyHndl;
UniChar uc;
VDKEY   vdkey;
VSCAN   pmscan;
ULONG   efshift;
integer rc;
...
rc = UniUntranslateKey(keyHndl, uc, vdkey, pmscan, efshift);
...

Related Functions

• UniTranslateDeadKey
• UniTranslateKey

Notes

UniUntranslateKey reverses the translation performed by UniTranslateKey. This is used to create a complete keyboard packet when an already translated character is entered. This is used when the input to the event is the translated character.

Typically, the Unicode character or virtual/dead key is given. If both are given, UniUntranslateKey processes the virtual/dead key before the Unicode character.

OS Version Introduced

• OS/2 Warp