WAIT

Purpose

Suspend program execution pending a key press or mouse-click or CLEAR EVENTS command.

Syntax

WAIT [<expC>]

[CLEAR]

[NOCLEAR}

[NOWAIT]

[TO <memvar>]

[TIMEOUT <expN>]

[WINDOW]

[EVENTS]

Description

The WAIT command displays the specified prompt <expC> on the screen and suspends program execution until a key is pressed or mouse is clicked. If no <expC> is specified, then "Click Ok to continue" is displayed. The key that is read from the keyboard is not echoed.

CLEAR

The CLEAR keyword will remove a system window or window message when the WAIT command is called from a program.

NOCLEAR

The NOCLEAR keyword is included for syntax compatibility only.

NOWAIT

The NOWAIT keyword will display the message but not require user input to continue execution.

TIMEOUT <expN>

The TIMEOUT clause lets you specify the number of seconds, <expN>, the message will remain on the screen before the program execution continues.

TO <memvar>

Syntax only.

WINDOW

The WINDOW keyword will cause the message to be displayed in the system message window.

EVENTS

WAIT EVENTS suspends execution until a CLEAR EVENTS command is executed from an asynchronous delegate such as a websocket.

Example

wait "Click to continue"