ON DELAY

Defines an event branch after specified seconds.

ON DELAY seconds [,priority] action

Usage:

ON DELAY Seconds,Priority CALL Sub1

ON DELAY 3 GOTO 5710

ON DELAY Maxtime,4 GOSUB Branch

Example: ON DELAY.BAS

Description:

ON DELAY defines a one time event branch to take after a specified number of seconds (as opposed to ON CYCLE which continues to cycle). The value of seconds can range from 0.01 to 167772.16 but is rounded to the timing resolution of the computer.

There is only one DELAY timer. Executing a new ON DELAY while another ON DELAY is still in effect will cause the DELAY timer to use the new seconds value. If the ON DELAY is executed in a different program context, the original ON DELAY definition is restored when control returns to the calling context. The old DELAY time is not restored, however.

ON DELAY is canceled by OFF DELAY and disabled by DISABLE. A SUBEXIT, SUBEND, or RETURN from the defining subprogram also cancels it.

More information about ON DELAY can be found under the "Common Information" heading of the ON CYCLE manual entry.