Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

:nON PLAY(n) Statement Details
  ◄QuickSCREEN►      ◄Details►      ◄Example►      ◄Contents►      ◄Index►
──────────────────────────────────────────────────────────────────────────────
ON PLAY(n) Statement Details
 
Syntax
  ON PLAY(queuelimit) GOSUB {linelabel | linenumber}
 
The following three rules apply to the use of ON PLAY:
 
  1. A play event trap occurs only when music is playing in the
     background. Play event traps do not occur when music is running
     in the foreground.
 
  2. A play event trap does not occur if the background music queue
     has already gone from having queuelimit to queuelimit -1
     notes when a PLAY ON is executed.
 
  3. If queuelimit is a large number, event traps may occur often
     enough to slow down the program.