Please enable JavaScript to view this site.

ESL Documentation

MESSAGE Function

Create a message box with a 'Help' button that displays help when the user presses that button or the F1 key.

ReplyToMessageWithHelpButton(TITLE_SV, MESSAGE_SV, OPTIONS_IV, DEFAULT_OPTION_IV, ICON_IV, HELP_PANEL_ID_SV)

TITLE_SV

A string value that you want to appear as the title of the message box.

MESSAGE_SV

A string value that is the text of the message.

OPTIONS_IV

One of the following integer constants, indicating the replies from which the user can choose:

MessageOK

MessageAbortRetryIgnore

MessageOKCancel

MessageYesNo

MessageRetryCancel

MessageYesNoCancel

MessageCancelTryContinue

DEFAULT_OPTION_IV

An integer value (1-3) that specifies the option that is the default for the OPTION_SV specified.

1 indicates that the first option is the default;

2 indicates that the second option is the default.

For example, specifying 2 with the MessageYesNo option indicates that the default option is "no".

ICON_IV

One of the following integer constants, to indicate the icon that appears in the message box.

MessageQuery

MessageNoIcon

MessageWarning

MessageCritical

MessageInformation

If you do not want an icon, specify;

MessageNoIcon

HELP_PANEL_ID_SV

A string value representing the integer help ID that specifies the help topic you want displayed if the user presses the F1 key in the message box.

Description

Use this function to create a message box that displays help when the user presses the F1 key. When calling the function, you can select different values for each parameter to get a different message box each time.

For example, specifying MessageYesNo means the message box will present the user with two options: "yes" and "no". These options also determine the possible return values of the function. Because ReplyToMessageWithHelp( ) returns the option the user selected, the possible return values when you specify MessageYesNo are "yes" and "no". (Note: If an error condition occurs, "error" may be returned instead; "error" is always a possible return value.)

See Also

ReplyToMessage( ) MESSAGE Function

ReplyToMessageWithHelp( ) MESSAGE Function