次の方法で共有


MessageBoxIndirectW 関数 (winuser.h)

メッセージ ボックスを作成、表示、および操作します。 メッセージ ボックスには、アプリケーション定義のメッセージ テキストとタイトル、任意のアイコン、および定義済みのプッシュ ボタンの任意の組み合わせが含まれます。

構文

int MessageBoxIndirectW(
  [in] const MSGBOXPARAMSW *lpmbp
);

パラメーター

[in] lpmbp

型: const LPMSGBOXPARAMS

メッセージ ボックスの表示に使用する情報を含む MSGBOXPARAMS 構造体へのポインター。

戻り値

型: int

関数が成功した場合、戻り値は次のいずれかのメニュー項目値になります。

メッセージ ボックスに [キャンセル] ボタンがある場合は、esc キーを押すか、[キャンセル] ボタンが選択されている場合、IDCANCEL 値を返します。 メッセージ ボックスに [キャンセル] ボタン がない場合、Esc キーを押しても効果はありません。

メッセージ ボックスを作成するのに十分なメモリがない場合、戻り値は 0 です。

戻りコード/値 形容
IDABORT の
3
[中止] ボタンが選択されました。
IDCANCEL
2
[キャンセル] ボタンが選択されました。
IDCONTINUE
11
[続行] ボタンが選択されました。
IDIGNORE
5
[ 無視] ボタンが選択されました。
IDNO
7
[ なし] ボタンが選択されました。
IDOK を する
1
[OK] ボタンが選択されました。
IDRETRY の
4
[再試行] ボタンが選択されました。
IDTRYAGAIN
10
再試行 ボタンが選択されました。
IDYES を する
6
[はい] ボタンが選択されました。

備考

システム モーダル メッセージ ボックスを使用して、システムがメモリ不足であることを示す場合、リソースの読み込みが失敗する可能性があるため、lpszText および lpszCaptionMSGBOXPARAMS 構造体のメンバーをリソース ファイルから取得しないでください。

ダイアログ ボックスが存在する間にメッセージ ボックスを作成する場合は、hWnd パラメーターとしてダイアログ ボックスへのハンドルを使用します。 hWnd パラメーターは、ダイアログ ボックス内のコントロールなどの子ウィンドウを識別しないでください。

手記

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MessageBoxIndirect を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll
API セットの ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8 で導入)

関連項目

概念

ダイアログ ボックス

MSGBOXPARAMS の

MessageBox

MessageBoxEx

リファレンス