UniUntranslateKey: Difference between revisions

Latest revision as of 17:57, 4 December 2019

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:

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

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

@@ Line 1: / Line 1: @@
-== UniUntranslateKey ==
+Translates a Unicode character and virtual/dead key to a scan code to create the effective shift state.
-; UniUntranslateKey(keyHndl, uc, vdkey, pmscan, efshift) : 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 - [[OS2 API:DataType:KHAND|KHAND]] - input : The keyboard handle as created by [[OS2_API:UniCreateKeyboard|UniCreateKeyboard]]
+;keyHndl - [[KHAND]] - input : The keyboard handle as created by [[UniCreateKeyboard]]
-; uc - [[OS2 API:DataType:UniChar|UniChar]] - input : Unicode character to be untranslated
+;uc - [[UniChar]] - input : Unicode character to be untranslated
-; vdkey - [[OS2 API:DataType:VDKEY|VDKEY]] - input : Virtual/dead key
+;vdkey - [[VDKEY]] - input : Virtual/dead key
-; pmscan - [[OS2 API:DataType:VSCAN|VSCAN]] - output : The [[OS2 API:PMI|Presentation Manager]] scan code
+;pmscan - [[VSCAN]] - output : The Presentation Manager scan code
 ; efshift - [[ULONG]] - output : Effective shift state to generate this character
@@ Line 14: / Line 16: @@
 === Returns ===
 An integer with values of:
-* [[OS2 API:Unicode:error#ULS_BADHANDLE|ULS_BADHANDLE]]
+* [[Unicode Errors#ULS_BADHANDLE|ULS_BADHANDLE]]
-* [[OS2 API:Unicode:error#ULS_NOSCAN|ULS_NOSCAN]]
+* [[Unicode Errors#ULS_NOSCAN|ULS_NOSCAN]]
-* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
+* [[Unicode Errors#ULS_SUCCESS|ULS_SUCCESS]]
 === Calling Convention ===
@@ Line 22: / Line 24: @@
 === Example Code ===
-  [[OS2 API:DataType:KHAND|KHAND]]   keyHndl;
+  KHAND   keyHndl;
-  [[UniChar]] uc;
+  UniChar uc;
-  [[OS2 API:DataType:VDKEY|VDKEY]]   vdkey;
+  VDKEY   vdkey;
-  [[OS2 API:DataType:VSCAN|VSCAN]]   pmscan;
+  VSCAN   pmscan;
-  [[ULONG]]   efshift;
+  ULONG   efshift;
   integer rc;
   ...