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)