Cicode Programming Reference > Cicode Function Categories > Miscellaneous Functions Introduction > Message

Message

Displays a message box on the screen and waits for the user to select the OK or Cancel button.

This function is a blocking function. It will block the calling Cicode task until the operation is complete.

Syntax

Message(Title, Prompt, Mode)

Title:

The title of the message box.

Prompt:

The prompt displayed in the message box.

Mode:

The mode of the message box:

0 - OK button

1 - OK and Cancel button

16 - Stop Icon

32 - Question Icon

48 - Exclamation Icon

64 - Information Icon

Select more than one mode by adding the modes. For example, set Mode to 33 to display the OK and Cancel buttons and the Question icon. You can only display one icon for the message box.

Return Value

0 (zero) if successful, otherwise an error is returned. If the user presses the Cancel button the function returns an error code of 299.

Related Functions

Input

Example

/* Display an error message in a message box. */
IF Total<>100 THEN
Message("Error","Total not 100%",48);
END

See Also

Miscellaneous Functions