AfxMessageBox
画面のメッセージ ボックスを表示します。
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
パラメーター
lpszText
CString をポイントし、またはメッセージ ボックスに表示するメッセージを含む終了する文字列オブジェクト。nType
メッセージ ボックスのフォーム。ボックスに メッセージ ボックスのフォーム 適用します。nIDHelp
メッセージのヘルプ コンテキスト ID; 0 では、アプリケーションの既定のヘルプ コンテキストを使用することを示します。nIDPrompt
文字列テーブルの文字列を参照するために使用される一意の ID。
戻り値
メッセージ ボックスを表示できる十分なメモリがない場合、; それ以外の場合は、次の値の 1 つが場合:
IDABORT アボートのボタンが選択されています。
IDCancel Cancel ボタンが選択されています。
IDIGNORE は無視されますのボタン選択されています。
IDNO ボタンは選択されていません。
IDOK [OK] ボタン選択されています。
IDRETRY は再試行のボタン選択されています。
IDYES はい] ボタンの選択されています。
メッセージ ボックスが Cancel ボタンがある場合、 IDCancel 値は、 Esc キーが押された場合は、 Cancel ボタンが選択された場合。メッセージ ボックスが Cancel ボタンがない場合、 Esc キーを押す操作は無効です。
関数 AfxFormatString1 と AfxFormatString2 は、メッセージ ボックスに表示されるテキストの書式設定に便利です。
解説
このオーバーロードされた関数の最初の形式は、メッセージ ボックスの lpszText によって指されるテキスト文字列を表示する場合、ヘルプ コンテキストを記述するために nIDHelp を使用します。ユーザーがヘルプ キー （通常は） F1 キーを押すと、関連するヘルプ トピックへジャンプするためにヘルプ コンテキストが使用されます。
関数の 2 番目の形式はメッセージ ボックスのメッセージを表示するために ID nIDPrompt の文字列リソースを使用します。関連するヘルプ ページは nIDHelpの値によってあります。nIDHelp の既定値が使用される （– 1）の文字列リソースの ID、 nIDPromptは、ヘルプ コンテキストに使用されます。ヘルプ コンテキストの定義方法の詳細については、 テクニカル ノート 28を参照してください。
使用例
// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));
// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);
必要条件
ヘッダー: afxwin.h