WinMessageBox - Parameters

hwndParent (HWND) - input

Parent-window handle of the created message-box window.

HWND_DESKTOP

The message box is to be main window.
Other
Parent-window handle.

hwndOwner (HWND) - input

Requested owner-window handle of the created message-box window.

The actual owner window is calculated using the algorithm specified in the description of the WinLoadDlg function.

pszText (PSZ) - input

Message-box window message.

The text of the message to be displayed within the message-box window. If multiple lines are required, carriage-return characters must be inserted into the text at appropriate points.

pszCaption (PSZ) - input

Message-box window title.

The text for the title should not be longer than 40 characters. If text longer than this is supplied, text centering is still performed, even though the beginning and end of the string are not visible.

NULL

The text Error is to be displayed as the title of the message-box window.
Other
The text to be displayed as the title of the message-box window.

idWindow (ULONG) - input

Message-box window identity.

This value is passed to the HK_HELP hook if the WM_HELP message is received by the message-box window. It must be greater or equal to 0 and less or equal to 0xFFFF.

flStyle (ULONG) - input

Message-box window style.

These values may be combined using the logical-OR operation but only one value can be taken from each of the following groups.

Button or Button Group

MB_OK

Message box contains an OK push button.
MB_OKCANCEL
Message box contains both OK and CANCEL push buttons.
MB_CANCEL
Message box contains a CANCEL push button.
MB_ENTER
Message box contains an ENTER push button.
MB_ENTERCANCEL
Message box contains both ENTER and CANCEL push buttons.
MB_RETRYCANCEL
Message box contains both RETRY and CANCEL push buttons.
MB_ABORTRETRYIGNORE
Message box contains ABORT, RETRY, and IGNORE push buttons.
MB_YESNO
Message box contains both YES and NO push buttons.
MB_YESNOCANCEL
Message box contains YES, NO, and CANCEL push buttons.
Help button

MB_HELP

Message box contains a HELP push button. When this is selected a WM_HELP message is sent to the window procedure of the message box.
Color or Icon

MB_ERROR

Message box contains a small red circle with a red line across it.
MB_ICONASTERISK
Message box contains an information (i) icon.
MB_ICONEXCLAMATION
Message box contains an exclamation point (!) icon.
MB_ICONHAND
Message box contains a small red circle with a red line across it.
MB_ICONQUESTION
Message box contains a question mark (?) icon.
MB_INFORMATION
Message box contains an information (i) icon.
MB_NOICON
Message box is not to contain an icon.
MB_QUERY
Message box contains a question mark (?) icon.
MB_WARNING
Message box contains an exclamation point (!) icon.
Default action

MB_DEFBUTTON1

The first button is the default selection. This is the default case, if none of MB_DEFBUTTON1, MB_DEFBUTTON2, and MB_DEFBUTTON3 is specified.
MB_DEFBUTTON2
The second button is the default selection.
MB_DEFBUTTON3
The third button is the default selection.
Modality indicator

MB_APPLMODAL

Message box is application modal. This is the default case. Its owner is disabled; therefore, do not specify the owner as the parent if this option is used.
MB_SYSTEMMODAL
Message box is system modal.
Mobility indicator

MB_MOVEABLE

Message box is moveable.

The message box is displayed with a title bar and a system menu, which shows only the Move, Close, and Task Manager choices, which can be selected either by use of the pointing device or by accelerator keys.

If the user selects Close, the message box is removed and the usResponse is set to MBID_CANCEL, whether or not a cancel button existed within the message box.

usResponse (ULONG) - returns

User-response value.

MBID_ENTER

ENTER push button was selected
MBID_OK
OK push button was selected
MBID_CANCEL
CANCEL push button was selected
MBID_ABORT
ABORT push button was selected
MBID_RETRY
RETRY push button was selected
MBID_IGNORE
IGNORE push button was selected
MBID_YES
YES push button was selected
MBID_NO
NO push button was selected
MBID_ERROR
Function not successful; an error occurred.

---

[Back: WinMessageBox Return Value - usResponse]
[Next: WinMessageBox - Remarks]