83Plus:BCALLs:4021

Synopsis

Official Name: MonForceKey

BCALL Address: 4021

Calls the system monitor but allows the programmer to push an initial key through cxMain. This is very much like Mon.

Inputs

• a = initial key press to simulate
• AppAllowContext, (IY + APIFlg) = 1 to allow Mon to pass context keys, like
• kYequ to the cxMain routine.
• CurLock, (IY + curFlags) = 1 to lock the cursor off

Outputs

• none

Registers Destroyed

• Doesn't matter because it doesn't return

Comments

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 MonForceKey  ;should see the number 8 appear in the edit buffer