This documentation is archived and is not being maintained.

CWnd::MessageBox

Creates and displays a window that contains an application-supplied message and caption, plus a combination of the predefined icons and pushbuttons described in the Message-Box Styles list.

int MessageBox(
   LPCTSTR lpszText,
   LPCTSTR lpszCaption = NULL,
   UINT nType = MB_OK 
);

Parameters

lpszText
Points to a CString object or null-terminated string containing the message to be displayed.
lpszCaption
Points to a CString object or null-terminated string to be used for the message-box caption. If lpszCaption is NULL, the default caption "Error" is used.
nType
Specifies the contents and behavior of the message box.

Return Value

Specifies the outcome of the function. It is 0 if there is not enough memory to create the message box.

Remarks

Use the global function AfxMessageBox instead of this member function to implement a message box in your application.

The following shows the various system icons that can be used in a message box:

MB_ICONHAND, MB_ICONSTOP, and MB_ICONERROR
MB_ICONQUESTION
MB_ICONEXCLAMATION and MB_ICONWARNING
MB_ICONASTERISK and MB_ICONINFORMATION

Example

void CMyWnd::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox("Help, Something went wrong.", "Error", 
      MB_ICONERROR | MB_OK);
}

See Also

CWnd Overview | Class Members | Hierarchy Chart | MessageBox | AfxMessageBox

Show: