# Function Reference

MsgBox

Displays a simple message box with optional timeout.

MsgBox ( flag, "title", "text" [, timeout] )

Parameters

flag | The flag indicates the type of message box and the possible button combinations. See remarks.
title | The title of the message box.
text | The text of the message box.
timeout | [optional] Timeout in seconds. After the timeout has elapsed the message box will be automatically closed.

Return Value

Success: | Returns the ID of the button pressed.
Failure: | Returns -1 if the message box timed out.

Button Pressed | Return Value
OK | 1
CANCEL | 2
ABORT | 3
RETRY | 4
IGNORE | 5
YES | 6
NO | 7
TRY AGAIN ** | 10
CONTINUE ** | 11

Remarks

The flag parameter can be a combination of the following values:

decimal flag | Button-related Result | hexadecimal flag
0 | OK button | 0x0
1 | OK and Cancel | 0x1
2 | Abort, Retry, and Ignore | 0x2
3 | Yes, No, and Cancel | 0x3
4 | Yes and No | 0x4
5 | Retry and Cancel | 0x5
6 ** | Cancel, Try Again, Continue | 0x6
decimal flag | Icon-related Result | hexadecimal flag
0 | (No icon) | 0x0
16 | Stop-sign icon | 0x10
32 | Question-mark icon | 0x20
48 | Exclamation-point icon | 0x30
64 | Information-sign icon consisting of an 'i' in a circle | 0x40
decimal flag | Default-related Result | hexadecimal flag
0 | First button is default button | 0x0
256 | Second button is default button | 0x100
512 | Third button is default button | 0x200
decimal flag | Modality-related Result | hexadecimal flag
0 | Application | 0x0
4096 | System modal (dialog has an icon) | 0x1000
8192 | Task modal | 0x2000
decimal flag | Miscellaneous-related Result | hexadecimal flag
0 | (nothing else special) | 0x0
262144 | MsgBox has top-most attribute set | 0x40000
524288 | title and text are right-justified | 0x80000

** Only valid on Windows 2000/XP and above.
For example, to specify a SYSTEMMODAL box with the YES/NO buttons the flag value would be 4096+4 (or 4100) If using hexadecimal flags, that would be 0x1000+0x4 (or 0x1004).
A message box appears centered on screen and resizes according to the text it contains. However, the title could get truncated if the SYSTEMMODAL flag (4096) is used.

Related

InputBox, ToolTip, TrayTip, SplashTextOn

Example

MsgBox(4096, "Test", "This box will time out in 10 seconds", 10)