Message() (tick_24Validator Engine Only)

int Message(int $display, int $messagetype, string $message[, location exp $location]);

$display - if nonzero, then the message is displayed; if zero (0), then the message is not displayed

$messagetype - the type of message to display

MSGBOX_INFORMATION - displays a standard windows information dialog box on the display

MSGBOX_ERROR - displays a standard windows error dialog box on the display

MSGBOX_WARNING - displays a standard windows warning dialog box on the display

MSGBOX_YESNOQUESTION - displays a standard windows question dialog box on the display with 'Yes' and 'No' buttons; returns 1 if the user answers 'Yes' or returns 0 if the user answers 'No'

MSG_ERROR - adds an error message to the message output of the validator

MSG_WARNING - adds a warning message to the message output of the validator

MSG_COMMENT - adds a comment message to the message output of the validator

MSG_MESSAGE - adds a general message to the message output of the validator

$message - the actual message text to display

$location - (OPTIONAL) points to the location in the html document that caused the message to be generated; the default is the first character of the tag name; this parameter is not used if $messagetype is MSGBOX_*.

Return value - see the return value for MessageEx();

Do not use the optional location argument if using a MSGBOX_* message type.

Start validation and end validation programs may only display comment type messages.

Example:

function onStartValidation() {
 Message(true, MSG_COMMENT, "User functions loaded. Starting the validation!");
}