MessageBoxIndirectA 関数 (winuser.h)
メッセージ ボックスを作成、表示、および操作します。 メッセージ ボックスには、アプリケーション定義のメッセージ テキストとタイトル、任意のアイコン、および定義済みのプッシュ ボタンの任意の組み合わせが含まれます。
構文
int MessageBoxIndirectA(
[in] const MSGBOXPARAMSA *lpmbp
);
パラメーター
[in] lpmbp
型: const LPMSGBOXPARAMS
メッセージ ボックスの表示に使用する情報を含む MSGBOXPARAMS 構造体へのポインター。
戻り値
型: int
関数が成功した場合、戻り値は次のいずれかのメニュー項目値になります。
メッセージ ボックスに [キャンセル] ボタンがある場合は、esc キーを押すか、[キャンセル] ボタンが選択されている場合、IDCANCEL 値を返します。 メッセージ ボックスに [キャンセル] ボタン
メッセージ ボックスを作成するのに十分なメモリがない場合、戻り値は 0 です。
戻りコード/値 | 形容 |
---|---|
|
[中止] ボタンが選択されました。 |
|
[キャンセル] ボタンが選択されました。 |
|
[続行] ボタンが選択されました。 |
|
[ 無視] ボタンが選択されました。 |
|
[ なし] ボタンが選択されました。 |
|
[OK] ボタンが選択されました。 |
|
[再試行] ボタンが選択されました。 |
|
再試行 ボタンが選択されました。 |
|
[はい] ボタンが選択されました。 |
備考
システム モーダル メッセージ ボックスを使用して、システムがメモリ不足であることを示す場合、リソースの読み込みが失敗する可能性があるため、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 の
リファレンス