MessageBox() Return Codes
If a message box has a Cancel
button, the function returns the IDCANCEL value if either the ESC key
is pressed or the Cancel button is selected. If a
message box has no Cancel button, pressing ESC has
no effect.
| Constant |
Value | Description |
|---|---|---|
| IDOK |
1
|
OK button was selected. |
| IDCANCEL |
2
|
Cancel button was selected |
| IDABORT |
3
|
Abort button was selected |
| IDRETRY |
4
|
Retry button was selected |
| IDIGNORE |
5
|
Ignore button was selected |
| IDYES |
6
|
Yes button was selected |
| IDNO |
7
|
No button was selected |
| IDTRYAGAIN |
10
|
Try Again button was selected |
| IDCONTINUE |
11
|
Continue button was selected |
These return codes are defined in the WinUser32.mqh file, so this header file must be included in programs by #include <WinUser32.mqh>.
The MessageBox()
function flags specify the contents and behavior of a dialog box. This
value can be a combination of flags from the following groups of flags:
| Constant | Value | Description |
|---|---|---|
| MB_OK | 0x00000000 | The message box contains one push button: OK. This is the default. |
| MB_OKCANCEL | 0x00000001 | The message box contains two push buttons: OK and Cancel. |
| MB_ABORTRETRYIGNORE | 0x00000002 | The message box contains three push buttons: Abort, Retry, and Ignore. |
| MB_YESNOCANCEL | 0x00000003 | The message box contains three push buttons: Yes, No, and Cancel. |
| MB_YESNO | 0x00000004 | The message box contains two push buttons: Yes and No. |
| MB_RETRYCANCEL | 0x00000005 | The message box contains two push buttons: Retry and Cancel. |
| MB_CANCELTRYCONTINUE | 0x00000006 | The message box contains three push buttons: Cancel, Try Again, Continue. |
To display an icon in a message box define the
additional flags:
| Constant | Value | Description |
|---|---|---|
| MB_ICONSTOP MB_ICONERROR MB_ICONHAND |
0x00000010 | A stop-sign icon appears in the message box. |
| MB_ICONQUESTION | 0x00000020 | A question-mark icon appears in the message box. |
| MB_ICONEXCLAMATION MB_ICONWARNING |
0x00000030 | An exclamation-point icon appears in the message box. |
| MB_ICONINFORMATION MB_ICONASTERISK |
0x00000040 | An icon consisting of a lowercase letter i in a circle appears in the message box. |
Default buttons are specified with the following
flags:
| Constant | Value | Description |
|---|---|---|
| MB_DEFBUTTON1 | 0x00000000 | The first burron MB_DEFBUTTON1 is the
default button, unless MB_DEFBUTTON2, MB_DEFBUTTON3, or MB_DEFBUTTON4
is specified. |
| MB_DEFBUTTON2 | 0x00000100 | The second button is the default button. |
| MB_DEFBUTTON3 | 0x00000200 | The third button is the default button. |
| MB_DEFBUTTON4 | 0x00000300 | The fourth button is the default button. |
MessageBox() function behavior flags are defined in the WinUser32.mqh file, this is why this heading file must be included to programs through #include <WinUser32.mqh>. Not all possible flags are listed here. For more details, please refer to Win32 API description.