BB___WAIT

=WAIT= toc

Description
> Halts program execution and waits for a user action. Also used with the timer statement to wait for the timer to fire.

> See TIMER.

Syntax

 * 1) wait

Hints
> When a branch or routine does not return upon completion to the place in the code where it was initially called, the WAIT command will prevent the code from "falling through" and executing the next branch or line of code - unless, of course, that is what you want the program to do.

> If using WAIT inside a sub or a function, be sure that any action the user may take after the WAIT can be handled from within the routine, and the END SUB (or END FUNCTION) statement can be executed. This will enable the program to return to where it was called.

Example
code format="lb" ' This example shows the use of WAIT to halt program execution, ' and also to WAIT for the Windows timer to tick down. nomainwin

button #1.btn, "OK!", [quit], UL, 125, 100 statictext #1.st, "", 85, 150, 150, 35

open "Waiting for user action..." for window as #1 #1 "trapclose [quit]"

[begin] ' Wait here until user clicks button #1.st "Press OK when ready."; chr$(13);_

wait

[quit] ' Wait 2 seconds before closing timer 2000, [done] #1.st "Give me a couple seconds..."; chr$(13);_ "Closing, 1, 2, 3..." wait [done] timer 0

close #1 end code

Useful Functions
code format="lb" Place a useful function using this command here code