Function Reference


Displays a simple message box with optional timeout.

MsgBox ( flag, "title", "text" [, timeout = 0 [, hwnd]] )


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 close automatically. The default is 0, which is no timeout.
hwnd [optional] The window handle to use as the parent for this dialog.

Return Value

Success: the ID of the button pressed.
Failure: $IDTIMEOUT (-1) if the message box timed out.

Button Pressed Return Value
OK $IDOK (1)
NO $IDNO (7)

Constants are defined in MsgBoxConstants.au3.


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

Constant Name Decimal flag Button-related result Hexadecimal flag
$MB_OK 0 OK button 0x0
$MB_OKCANCEL 1 OK and Cancel 0x1
$MB_ABORTRETRYIGNORE 2 Abort, Retry, and Ignore 0x2
$MB_YESNOCANCEL 3 Yes, No, and Cancel 0x3
$MB_YESNO 4 Yes and No 0x4
$MB_RETRYCANCEL 5 Retry and Cancel 0x5
$MB_CANCELTRYCONTINUE 6 Cancel, Try Again, Continue 0x6
$MB_HELP 16384 Adds a Help button to the message box. When the user clicks the Help button or presses F1, the system sends a WM_HELP message to the owner. 0x4000
Constant Name decimal flag Icon-related Result hexadecimal flag
$MB_ICONNONE 0 (No icon) 0x0
$MB_ICONERROR 16 Stop-sign icon 0x10
$MB_ICONQUESTION 32 Question-mark icon 0x20
$MB_ICONWARNING 48 Exclamation-point icon 0x30
$MB_ICONINFORMATION 64 Information-sign icon consisting of an 'i' in a circle 0x40
Constant Name decimal flag Default-related Result hexadecimal flag
$MB_DEFBUTTON1 0 First button is default button 0x0
$MB_DEFBUTTON2 256 Second button is default button 0x100
$MB_DEFBUTTON3 512 Third button is default button 0x200
$MB_DEFBUTTON4 768 Fourth button is default button 0x300
Constant Name decimal flag Modality-related Result hexadecimal flag
$MB_APPLMODAL 0 Application 0x0
$MB_SYSTEMMODAL 4096 System modal (dialog has an icon) 0x1000
$MB_TASKMODAL 8192 Task modal 0x2000
Constant Name decimal flag Miscellaneous-related Result hexadecimal flag
0 (nothing else special) 0x0
$MB_DEFAULT_DESKTOP_ONLY 131072 MsgBox() shows on the desktop of the interactive window station. 0x20000
$MB_RIGHT 524288 title and text are right-justified 0x80000
$MB_RTLREADING 1048576 Displays message and caption text using right-to-left reading order on Hebrew and Arabic systems. 0x100000
$MB_SETFOREGROUND 65536 The message box becomes the foreground window. 0x10000
$MB_TOPMOST 262144 MsgBox() has top-most attribute set 0x40000
$MB_SERVICE_NOTIFICATION 2097152 The function displays a message box on the current active desktop, even if there is no user logged on to the computer. 0x200000

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.

If "title" is equal to Default keyword @ScriptName is used.

Special note; MsgBox does not support the use of the timeout parameter when the $MB_SERVICE_NOTIFICATION flag is used when calling MsgBox from a service. The message box window is not owned by the process calling MsgBox when $MB_SERVICE_NOTIFICATION is specified.

Constants are defined in MsgBoxConstants.au3.


InputBox, SplashTextOn, ToolTip, TrayTip


Example 1

#include <MsgBoxConstants.au3>

MsgBox($MB_SYSTEMMODAL, "Title", "This message box will timeout after 10 seconds or select the OK button.", 10)

Example 2

#include <MsgBoxConstants.au3>

Local $iTimeout = 10

; Display a message box with a nested variable in its text.
MsgBox($MB_SYSTEMMODAL, "Title", "This message box will timeout after " & $iTimeout & " seconds or select the OK button.", $iTimeout)