FloppusMaximus: New page: SendKPress SendKPress 4024 - SendKPress == Synopsis == '''Official Name:...

2009-09-24T00:52:07Z

New page: SendKPress SendKPress 4024 - SendKPress == Synopsis == '''Official Name:...

New page

[[Category:83Plus:BCALLs:By Name:Monitor|SendKPress]] [[Category:83Plus:BCALLs:By Name|SendKPress]] [[Category:83Plus:BCALLs:By Address|4024 - SendKPress]]
== Synopsis ==
'''Official Name:''' SendKPress

'''BCALL Address:''' 4024

Calls the system monitor but allows the programmer to push an initial key through [[83Plus:RAM:858D|cxMain]]. This is very much like [[83Plus:BCALLs:401E|Mon]] and [[83Plus:BCALLs:4021|MonForceKey]].

=== Inputs ===
* A = initial key press to simulate
* [[83Plus:Flags:28|AppAllowContext, (IY + APIFlg)]] = 1 to allow Mon to pass context keys, like kYequ to the cxMain routine.
* [[83Plus:Flags:0C|CurLock, (IY + curFlags)]] = 1 to lock the cursor off

=== Outputs ===
* none

=== Registers Destroyed ===
* Doesn't matter because it doesn't return

== Comments ==
This routine is similar to [[83Plus:BCALLs:4021|MonForceKey]], but the initial keypress is passed more-or-less directly to cxMain (whereas MonForceKey passes the keypress to the [[83Plus:Hooks:9B84|raw key hook]], if enabled, and handles the various special keys.)

The system NEVER returns from this B_CALL. The programmer should find alternative methods of regaining control and exiting such as hooks, cxMain, etc.

== Example ==
To simulate a key press by the user when first entering the system monitor:

;set up edit buffer
;...
ld a,k8
B_CALL SendKeyPress ;should see the number 8 appear in the edit buffer

83Plus:BCALLs:4024 - Revision history

FloppusMaximus: New page: SendKPress SendKPress 4024 - SendKPress == Synopsis == '''Official Name:...