keyInformation (KKI)
Summary
Returns an object with extended information about a specified keystroke event.
Syntax
keyman.interface.keyInformation(e);
or
KeymanWeb.KKI(e); // Shorthand
Parameters
e
: Type: Object
: The event object to be evaluated.
Return Value
Object
: An object with extended key event information.
Description
Note: This function will not succeed if it is called from outside of a keyboard's standard text-processing operations.
The key_event
object contains the following members:
vk
: boolean
: A flag indicating whether or not the event corresponds to a virtual key.
code
: number
: The underlying keycode for the event.
modifiers
: number
: A set of bit-flags corresponding to the SHIFT, CTRL, and ALT state of the keyboard.
The bit masks for each modifier are as follows:
-
SHIFT :
0x10
-
CTRL :
0x20
-
ALT :
0x40