Jump to content

UniUntranslateKey: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
mNo edit summary
Line 3: Line 3:


=== Parameters ===
=== Parameters ===
; keyHndl - [[OS2 API:DataType:KHAND|KHAND]] - input : The keyboard handle as created by [[OS2_API:UniCreateKeyboard|UniCreateKeyboard]].
; keyHndl - [[OS2 API:DataType:KHAND|KHAND]] - input : The keyboard handle as created by [[OS2_API:UniCreateKeyboard|UniCreateKeyboard]]
; uc - [[OS2 API:DataType:UniChar|UniChar]] - input : Unicode character to be untranslated.
; uc - [[OS2 API:DataType:UniChar|UniChar]] - input : Unicode character to be untranslated
; vdkey - [[OS2 API:DataType:VDKEY|VDKEY]] - input : Virtual/dead key.
; vdkey - [[OS2 API:DataType:VDKEY|VDKEY]] - input : Virtual/dead key
; pmscan - [[OS2 API:DataType:VSCAN|VSCAN]] - output : The [[OS2 API:PMI|Presentation Manager]] scan code.
; pmscan - [[OS2 API:DataType:VSCAN|VSCAN]] - output : The [[OS2 API:PMI|Presentation Manager]] scan code
; efshift - [[OS2 API:DataType:ULONG|ULONG]] - output : Effective shift state to generate this character.
; efshift - [[ULONG]] - output : Effective shift state to generate this character


=== Constants ===
=== Constants ===
Line 17: Line 17:
* [[OS2 API:Unicode:error#ULS_NOSCAN|ULS_NOSCAN]]
* [[OS2 API:Unicode:error#ULS_NOSCAN|ULS_NOSCAN]]
* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
=== Module ===
=== Define (C/C++) ===
=== Export name/Ordinal ===


=== Calling conversion ===
=== Calling conversion ===
Line 29: Line 23:
=== Example Code ===
=== Example Code ===
  [[OS2 API:DataType:KHAND|KHAND]]  keyHndl;
  [[OS2 API:DataType:KHAND|KHAND]]  keyHndl;
  [[OS2 API:DataType:UniChar|UniChar]] uc;
  [[UniChar]] uc;
  [[OS2 API:DataType:VDKEY|VDKEY]]  vdkey;
  [[OS2 API:DataType:VDKEY|VDKEY]]  vdkey;
  [[OS2 API:DataType:VSCAN|VSCAN]]  pmscan;
  [[OS2 API:DataType:VSCAN|VSCAN]]  pmscan;
  [[OS2 API:DataType:ULONG|ULONG]]  efshift;
  [[ULONG]]  efshift;
  integer rc;
  integer rc;
  ...
  ...
Line 39: Line 33:


=== Related Functions ===
=== Related Functions ===
[[OS2 API:UniTranslateDeadKey|UniTranslateDeadKey]]
*[[UniTranslateDeadKey]]
[[OS2 API:UniTranslateKey|UniTranslateKey]]
*[[UniTranslateKey]]


=== Notes ===
=== Notes ===
[[OS2 API:UniUntranslateKey|UniUntranslateKey]] reverses the translation performed by [[OS2 API:UniTranslateKey|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.
[[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, [[OS2 API:UniUntranslateKey|UniUntranslateKey]] processes the virtual/dead key before the Unicode 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 Version Introduced ===
OS/2 Warp
*OS/2 Warp
 
 
 
[[OS2_API | Back to OS/2 API]]
 


[[Category:The OS/2 API Project]]
[[Category:Uni]]

Revision as of 20:12, 2 November 2016

UniUntranslateKey

UniUntranslateKey(keyHndl, uc, vdkey, pmscan, efshift)
Translates a Unicode character and virtual/dead key to a scan code to create the effective shift state.

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 conversion

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