次の方法で共有


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 キーを押す操作は無効です。

関数 AfxFormatString1AfxFormatString2 は、メッセージ ボックスに表示されるテキストの書式設定に便利です。

解説

このオーバーロードされた関数の最初の形式は、メッセージ ボックスの 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

参照

関連項目

CWnd::MessageBox

概念

MFC マクロとグローバル