MessageBox PROC
(MS-Windows)
Displays a simple message box and waits for the
user to acknowledge the message.
MessageBox PROTO, hWnd:DWORD, pText:PTR BYTE, pCaption:PTR BYTE, style:DWORD Returns: (int) EAX = One of the following: zero if not enough memory to display the box, IDABORT Abort button was selected. IDCANCEL Cancel button was selected. IDIGNORE Ignore button was selected. IDNO No button was selected. IDOK OK button was selected. IDRETRY Retry button was selected. IDYES Yes button was selected. |
Argument | Win Type | MASM Type | Description |
---|---|---|---|
hWnd | HWND | DWORD | Handle to the current window. |
pText | LPCTSTR | PTR BYTE | Pointer to a null-terminated string that will appear inside the box. |
pCaption | LPCTSTR | PTR BYTE | Pointer to a null-terminated string that will appear in the box's caption bar. |
style | UINT | DWORD | An integer that describes both contents and behavior
of the dialog box. Bit-wise combine from the following (see MSDN for details): · MB_ABORTRETRYIGNORE The message box contains three push buttons: Abort, Retry, and Ignore. · MB_OK The message box contains one push button: OK. This is the default. · MB_OKCANCEL The message box contains two push buttons: OK and Cancel. · MB_RETRYCANCEL The message box contains two push buttons: Retry and Cancel. · MB_YESNO The message box contains two push buttons: Yes and No. · MB_YESNOCANCEL The message box contains three push buttons: Yes, No, and Cancel. · MB_ICONEXCLAMATION or MB_ICONWARNING An exclamation-point icon appears in the message box. · MB_ICONINFORMATION or MB_ICONASTERISK An icon consisting of a lowercase letter i in a circle appears in the message box. · MB_ICONQUESTION A question-mark icon appears in the message box. · MB_ICONSTOP or MB_ICONERROR or MB_ICONHAND A stop-sign icon appears in the message box. · MB_DEFBUTTON1 The first button is the default button. · MB_DEFBUTTON1 (default). · MB_DEFBUTTON2 The second button is the default button. · MB_DEFBUTTON3 The third button is the default button. · MB_DEFBUTTON4 The fourth button is the default button. · MB_APPLMODAL The user must respond. · MB_SYSTEMMODAL Use for serious errors. · MB_TASKMODAL · MB_DEFAULT_DESKTOP_ONLY · MB_HELP · MB_RIGHT The text is right-justified. · MB_RTLREADING · MB_SETFOREGROUND · MB_TOPMOST · MB_SERVICE_NOTIFICATION · MB_SERVICE_NOTIFICATION_NT3X |
Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |