MessageBox()

Summary

Creates a dialog box with a message.

 

Syntax

button = MessageBox(string message, array options)

 

Argument	Contents
message	Text to display in the dialog box

 

Option	Type	Contents
Caption	String	Text to display in the title bar
Buttons	String	The buttons to display, one of the following strings:- "AbortRetryIgnore": three push buttons, Abort, Retry, and Ignore- "OK" or "Okay": one push button, OK (the default)- "OKCancel": two push buttons, OK and Cancel- "RetryCancel": two push buttons, Retry and Cancel- "YesNo": two push buttons, Yes and No- "YesNoCancel": three push buttons, Yes, No, and Cancel
Icon	String	The icon to display, one of the following strings:- "Exclamation" or "Warning": add an exclamation-point icon- "Information" or "Asterisk": add an icon with a lower case letter i in a circle (the default)- "Question": a question-mark icon- "Stop", "Error", or "Hand": add a stop-sign icon
Default	Integer	A value (1-4) indicating the default button, based on the button list; the Help option below can add a button to the end of the list; the default is 1
Modal	String	The modal style of the dialog box, one of the following strings:- "Appl": the user must respond before continuing work in the application (default)- "System": notify the user of serious, potentially damaging errors that require immediate attention by bringing the message box to the foreground, even if the application is in the background- "Task": without suspending other threads
Options	Array	Additional options in an array of one or more strings:- "Help": adds a Help button to the message box; choosing the Help button or pressing F1 generates a Help event- "Right": the message text is right-justified- "RTLReading": displays message and caption text using right-to-left reading order on Hebrew and Arabic systems- "SetForeground": the message box becomes the foreground window- "TopMost": the message box is created as top-most window style

 

Returns

A string with the name of the button that the user clicked: "Abort", "Cancel", "Ignore", "No", "Ok", "Retry", or "Yes".

 

Notes

• The options to MessageBox() closely mirror options to the Windows MessageBox function.

Example

btn = MessageBox("Do you want to continue?",

                    {{"Caption", "Question"},

                    {"Buttons", "YesNo"}})

if btn = "No" then Return()

 

See Also

Function	Summary
ShowMessage()	Shows a message in a standard Windows message box
TaskDialog()	Creates an enhanced version of a standard Windows Messag