Updated May 2013
xcall MIAMEX, MX_RELEASEKBD {,opcode, text}
opcode (Num) [in]xe "MX_RELEASEKBD"
opcode |
Description |
0 or omitted |
causes the keyboard hold to be released, provided it hasn't been locked (see AG_HOLDKBD) |
1 |
causes the keyboard hold to be set, and optionally passes the contents of text to ATE to be reprocessed as type-ahead. |
2 |
clears the keyboard hold, even if it has been locked. |
History
2013 May, A-Shell 6.1.1352: Opcode 2 added
2005 November, A-Shell 4.9.946: Introduced a new and improved internal protocol for communications between the application and GUI front-end. One aspect of this new protocol involved setting and releasing keyboard holds so that keyboard input and GUI command responses did not get mixed together. MIAMEX 153 is used to control that keyboard hold. The application programmer will, under normal circumstances, never need this command, since A-Shell should take care of it automatically. It is nonetheless documented and made available for programmer use in case of some as-yet-unforeseen situation.