EchoBoxOn()

Display a message box on-screen while your script is executing.

Syntax

EchoBoxOn([<cTitle>], <[cMessage1]>, <[cMessage2]>) --> TRUE

Arguments

<cTitle> --> The optional title of the message box.

<cMessage1> --> An optional message to display inside the message box.

<cMessage2> --> An optional second message to display inside the message box.

Returns

This function always returns TRUE.

Description

Displays a message box while your script is running. This is useful to give users feedback that a process is underway when a long or complex script executes. The message box may have a title and up to two lines of messages inside the box.

You must call EchoBoxOff() following any call to EchoBoxOn() after your script has finished executing or when your script interacts with the end-user, such as when requesting input.

Example

* Display a message box test script

EchoBoxOn('Searching', 'Scanning Database...')

Stock->(GotoTop())

Declare MyCount Type Number

MyCount := 0

:Loop

If Stock->(EOF())

   Goto End

Endif

MyCount := MyCount + 1

If MyCount % 50 = 0

   EchoBox("Scanning..." + STR(MyCount))

Endif

Stock->(Skip())

Goto Loop

:End

EchoBoxOff()

____________________________

Related Topics:

Business Function List

EchoBox()

EchoBoxOff()