UniUntranslateKey: Difference between revisions
Appearance
No edit summary |
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 - [[ | ; 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]] | ||
=== Calling conversion === | === Calling conversion === | ||
Line 29: | Line 23: | ||
=== Example Code === | === Example Code === | ||
[[OS2 API:DataType:KHAND|KHAND]] keyHndl; | [[OS2 API:DataType:KHAND|KHAND]] keyHndl; | ||
[[ | [[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; | ||
[[ | [[ULONG]] efshift; | ||
integer rc; | integer rc; | ||
... | ... | ||
Line 39: | Line 33: | ||
=== Related Functions === | === Related Functions === | ||
[[ | *[[UniTranslateDeadKey]] | ||
[[ | *[[UniTranslateKey]] | ||
=== Notes === | === 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. | 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 | ||
[[Category: | [[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
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