[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
ON PLAY(n) Trap for Background Music Remaining
ON PLAY(queuelimit) GOSUB {linenum | linelabel}
Establishes a subroutine to which QuickBASIC will branch if fewer than
a specified number of notes remain in the background music buffer. T
he trap must also be turned on by means of a PLAY ON statement.
queuelimit An integer expression in the range 1 to 32 specifying the
number of notes to be trapped.
linenum The first line of a music-handling subroutine. Setting
linenum to 0 disables trapping.
linelabel A label identifying the first line of a music-handling
routine.
-----------------------------------------------------------------------
Notes: {linenum | linelabel} must be defined at the main program
level.
With trapping in effect, and when QuickBASIC is executing
music in the background mode, when the number of notes
remaining is fewer than queuelimit, QuickBASIC branches to
the specified subroutine and temporarily suspends trapping
(by means of an implicit PLAY STOP statement). Trapping
automatically resumes when a RETURN from the handling
subroutine is executed (unless the handler explicitly
performs a PLAY OFF or PLAY STOP).
All event trapping is temporarily disabled when QuickBASIC
is executing an error-handling routine (established via an
ON ERROR statement).
See Also:
PLAY (Event Trap)
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson