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 | 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 |
Related
InputBox, ToolTip, TrayTip, SplashTextOn
Example
MsgBox(4096, "Test", "This box will time out in 10 seconds", 10)