Developers guide

Chapter 9: Keyboard
Disabling The Keyboard
56 Psion Teklogix Mobile Devices SDK Developers Guide
9.1.2 Disabling The Keyboard
The keyboard can be disabled at the hardware level. When disabled, no key presses are recorded.
Disabling the keyboard may be used to prevent user data entry while a program is performing a
critical operation such as a database transaction or a screen refresh, when a key press could cause
problems.
Some keyboard operations are still available even when the keyboard is disabled, including resets,
and placing the computer into suspend mode.
9.1.3 Keyboard API Elements
C++: The display on all Psion Teklogix computers is controlled using the
PsionTeklogix::Keyboard namespace.
Java: The display on all Psion Teklogix computers is controlled using the
com.teklogix.keyboard package.
.NET: The display on all Psion Teklogix computers is controlled using the
PsionTeklogix.Keyboard namespace.
9.2 Keyboard Remapping
The key stroke information sent to an application when a key is pressed can be altered through a
process of remapping key code values. There are two sets of key codes — scan codes and virtual
key codes — which define the associations between a physical key pressed, and the key value that
is sent to an application. The default associations of these key code sets characterize the normal
behaviour of a particular keyboard. Keyboard remapping overrides the default behaviour of the
keyboard keys.
A scan code is an integer value representing a key on a keyboard. Psion Teklogix computers use a
hardware-independent list of scan codes that applies to all device models. See “Scan Codes For
Psion Teklogix Keyboards” on page 58 for a list of these scan codes.
NEO
26-Key
48-Key
Unknown
WORKABOUTPRO G1
24-Key Keyboard
52-Key Keyboard
WORKABOUTPRO G2
25-key
52-key
Unknown
Psion Teklogix Computer Keyboard Description Strings
Important: Take great care when disabling the keyboard. If an application terminates while
the keyboard is disabled, there is no easy way to re-enable the keyboard. This can
leave the computer in an unusable state (the touchscreen is still active, assuming
the computer has one).