83Plus:BCALLs:4021

From WikiTI
Revision as of 16:00, 12 April 2005 by Woozle (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

  •  ??

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