MessageBoxIndirectA 関数 (winuser.h)
メッセージ ボックスを作成、表示、操作します。 メッセージ ボックスには、アプリケーション定義のメッセージ テキストとタイトル、任意のアイコン、および定義済みのプッシュ ボタンの任意の組み合わせが含まれます。
構文
int MessageBoxIndirectA(
[in] const MSGBOXPARAMSA *lpmbp
);
パラメーター
[in] lpmbp
型: const LPMSGBOXPARAMS
メッセージ ボックスの表示に使用される情報を含む MSGBOXPARAMS 構造体へのポインター。
戻り値
型: int
関数が成功した場合、戻り値は次のいずれかのメニュー項目値になります。
メッセージ ボックスに [キャンセル] ボタンがある場合、ESC キーを押すか、[キャンセル] ボタンが選択されている場合、関数は IDCANCEL 値を返します。 メッセージ ボックスに [キャンセル] ボタンがない場合、Esc キーを押しても効果はありません。
メッセージ ボックスを作成するのに十分なメモリがない場合、戻り値は 0 です。
| リターン コード/値 | Description |
|---|---|
|
[ 中止] ボタンが選択されました。 |
|
[キャンセル] ボタンが選択されました。 |
|
[ 続行 ] ボタンが選択されました。 |
|
[無視] ボタンが選択されました。 |
|
[ いいえ ] ボタンが選択されました。 |
|
[OK] ボタンが選択されました。 |
|
[ 再試行 ] ボタンが選択されました。 |
|
[ 再試行] ボタンが選択されました。 |
|
[ はい ] ボタンが選択されました。 |
解説
システム がメモリ不足であることを示すためにシステム モーダル メッセージ ボックスを使用する場合、リソースの読み込みが失敗する可能性があるため、MSGBOXPARAMS 構造体の lpszText メンバーと lpszCaption メンバーが指す文字列をリソース ファイルから取得しないでください。
ダイアログ ボックスが存在する間にメッセージ ボックスを作成する場合は、ダイアログ ボックスのハンドルを hWnd パラメーターとして使用します。 hWnd パラメーターは、ダイアログ ボックス内のコントロールなどの子ウィンドウを識別しないでください。
注意
winuser.h ヘッダーは、MessageBoxIndirect をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8 で導入) |
関連項目
概念
参照