次の方法で共有

MessageBoxExA 関数 (winuser.h)

  • [アーティクル]

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

現在、MessageBoxEx と MessageBox 同じように動作します。

構文

int MessageBoxExA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType,
  [in]           WORD   wLanguageId
);

パラメーター

[in, optional] hWnd

型: HWND

作成するメッセージ ボックスの所有者ウィンドウへのハンドル。 このパラメーターが NULL場合、メッセージ ボックスには所有者ウィンドウがありません。

[in, optional] lpText

型: LPCTSTR

表示するメッセージ。

[in, optional] lpCaption

型: LPCTSTR

ダイアログ ボックスのタイトル。 このパラメーターが NULL場合、既定のタイトル Error が使用されます。

[in] uType

型: UINT

ダイアログ ボックスの内容と動作。 サポートされているフラグの詳細については、「MessageBox」を参照してください。

[in] wLanguageId

型: word

メッセージ ボックス ボタンに表示されるテキストの言語。 ゼロ (0) の値を指定すると、既定のシステム言語でボタン テキストが表示されます。 このパラメーターが MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)場合は、呼び出し元のスレッドに関連付けられている現在の言語が使用されます。

現在の言語以外の言語を指定するには、MAKELANGID マクロを使用してこのパラメーターを作成します。 詳細については、MAKELANGIDを参照してください。

戻り値

型: int

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

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

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

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

備考

システム モーダル メッセージ ボックスを使用して、システムがメモリ不足であることを示す場合、リソースの読み込み試行が失敗する可能性があるため、lpText および lpCaption パラメーターが指す文字列をリソース ファイルから取得しないでください。

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll

関連項目

概念

ダイアログ ボックス

MAKELANGID を する

MessageBeep

MessageBox

MessageBoxIndirect

その他のリソース を する

リファレンス

SetForegroundWindow の