Please enable JavaScript to view this site.

ESL Documentation

Use the Message Library to create message boxes. Message boxes are a quick and easy way to send a message and receive a reply (for example, to request confirmation when the user asks to quit the ESL session.)

 

Instead of creating and responding to message boxes using the ESL language as you would a key or a region, you make just one function call that creates and displays the message box you specify. Users must respond to the message box before performing any other ESL actions (such as selecting other objects). Once ESL receives the response, it removes the message box from the screen and returns the user's response to the ESL program.

 

Message Library functions return a lowercase string that is the text of the option taken in the message box. For example, if a message box specifies the options "MessageAbortRetryIgnore" and the user selects the "Retry" option, the function returns the string "retry".

 

The Message Library contains the functions shown in the following table. Specify include "message.inc" before using the functions.

Function Name

Operation

ReplyToMessage( )

Create a message box.

ReplyToMessageWithHelp( )

Create a message box that displays help

when the user presses F1.