MIAMEX 153: Set/release Keyboard Hold

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.