CWnd::MessageBox

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

アプリケーションに用意されているメッセージ、キャプション、およびメッセージボックススタイルの一覧で記述されている組み込みアイコンと組み込みプッシュボタンの組み合わせを持つウィンドウを作成し、表示します。

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

パラメータ

lpszText
表示するメッセージを持つ CString オブジェクトまたは NULL で終わる文字列へのポインタ。
lpszCaption
メッセージボックスのキャプションとして使われる CString オブジェクトまたは NULL で終わる文字列へのポインタ。lpszCaption が NULL の場合は、既定のキャプションである "Error" が使われます。
nType
メッセージボックスの内容と動作を指定します。

戻り値

このメソッドには、Windows SDK で定義されている MessageBox 関数が使用されています。この関数を呼び出した結果が、このメソッドによって返されます。

解説

アプリケーションにメッセージボックスを実装するには、このメンバ関数ではなくグローバル関数 AfxMessageBox を使用してください。

メッセージボックスで使用できるさまざまなシステムアイコンは以下のとおりです。

	MB_ICONHAND、MB_ICONSTOP、MB_ICONERROR
	MB_ICONQUESTION
	MB_ICONEXCLAMATION、MB_ICONWARNING
	MB_ICONASTERISK、MB_ICONINFORMATION

使用例

void CMainFrame::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(_T("Help, Something went wrong."), _T("Error"), 
      MB_ICONERROR | MB_OK);
}