Developers guide

Chapter 9: Keyboard
Key Insertion API Elements
Psion Teklogix Mobile Devices SDK Developers Guide 63
Before this feature is invoked, the focus must be on the relevant input field.
This feature is typically used for the following, described in further detail below:
• In application lock-down mode, displaying key presses in alpha mode.
• Reversing an accidental press of the [BLUE] key or the [ORANGE] key.
• As a keyboard wedge.
Application Lock-Down Mode
When an application is operating in lock-down mode, the Windows task bar is not visible. Nor-
mally, when a user is entering alpha characters on a computer with a numeric keyboard ([2ABC],
[3DEF], etc.), the intermediate characters are displayed on the Windows task bar until the desired
character is selected. Key insertion allows an application to display the intermediate alphabetic
characters directly in the input field.
Reversing Accidental Key Presses
If the [BLUE] or [ORANGE] key is accidently pressed by an operator during data entry, the
results can be unexpected and can cause an input error. Detecting the accidental modifier key
press, and reversing it within the application, ensures that the intended data is entered.
The Mobile Devices SDK provides functions that allow the [BLUE] key and the [ORANGE] key
presses to be intercepted. The key insertion feature allows the application to reverse the setting of
the key.
Keyboard Wedge
A keyboard wedge inserts characters into a field that is in focus. A single virtual key can be in-
serted into an input field by each call to the key insertion function. A command key, such as Send
unshifted code accompanied by a virtual key code, wedges the associated virtual key into the
input field.
9.3.1 Key Insertion API Elements
C++: Key insertion on all Psion Teklogix Windows computers is controlled using the
PsionTeklogix::Keyboard namespace.
Java: Key insertion on all Psion Teklogix Windows computers is controlled using the Keyboard
class in the com.teklogix.keyboard package.
.NET: Key insertion on all Psion Teklogix Windows computers is controlled using the Keyboard
class in the PsionTeklogix.Keyboard namespace.