次の方法で共有


MSGBOXPARAMSA 構造体 (winuser.h)

メッセージ ボックスの表示に使用する情報が含まれます。 MessageBoxIndirect 関数は、この構造体を使用します。

構文

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

メンバーズ

cbSize

型: UINT

構造体のサイズ (バイト単位)。

hwndOwner

型: HWND

所有者ウィンドウへのハンドル。 このメンバーは NULLできます。

hInstance

型: HINSTANCE

lpszIcon メンバーによって識別されるアイコン リソースと、lpszText または lpszCaption メンバーによって識別される文字列リソースを含むモジュールへのハンドル。

lpszText

型: LPCTSTR

null で終わる文字列、または表示するメッセージを含む文字列リソースの識別子。

lpszCaption

型: LPCTSTR

メッセージ ボックスのタイトルを含む null で終わる文字列、または文字列リソースの識別子。 このメンバーが NULL場合は、既定のタイトル Error が使用されます。

dwStyle

型: DWORD

ダイアログ ボックスの内容と動作。 このメンバーは、MessageBoxEx 関数の uType パラメーターに記述されているフラグの組み合わせにすることができます。

さらに、lpszIcon メンバーで指定されたアイコンをメッセージ ボックスに表示する場合は、MB_USERICON フラグ (0x00000080L) を指定できます。

lpszIcon

型: LPCTSTR

アイコン リソースを識別します。 このパラメーターには、null で終わる文字列、または MAKEINTRESOURCE マクロに渡される整数リソース識別子を指定できます。

標準のシステム定義アイコンのいずれかを読み込むには、hInstance メンバーを NULL に設定し、lpszIcon LoadIcon 関数で一覧表示されている値のいずれかに設定します。

dwStyle メンバーが MB_USERICON フラグを指定していない場合、このメンバーは無視されます。

dwContextHelpId

型: DWORD_PTR

ヘルプ コンテキストを識別します。 ヘルプ イベントが発生した場合、この値は、メッセージ ボックスが所有者ウィンドウまたはコールバック関数に送信する HELPINFO 構造体で指定されます。

lpfnMsgBoxCallback

型: MSGBOXCALLBACK

メッセージ ボックスのヘルプ イベントを処理するコールバック関数へのポインター。 コールバック関数の形式は次のとおりです。

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

このメンバーが NULL場合、ヘルプ イベントが発生したときに、メッセージ ボックス WM_HELP メッセージが所有者ウィンドウに送信されます。

dwLanguageId

型: DWORD

定義済みのプッシュ ボタンに含まれるテキストを表示する言語。 この値は、MAKELANGID マクロによって返される形式である必要があります。

サポートされている言語識別子の一覧については、「言語識別子参照してください。 通常、Windows のローカライズされた各リリースには、限られた言語のセットに対してのみリソースが含まれていることに注意してください。 したがって、例えば、米国版は LANG_ENGLISHを提供し、フランス語版は LANG_FRENCHを提供し、ドイツ語版は LANG_GERMANを提供し、日本版は LANG_JAPANESEを提供します。 各バージョンは LANG_NEUTRALを提供しています. これにより、dwLanguageId パラメーターで使用できる値のセットが制限されます。 言語識別子を指定する前に、システムにインストールされているロケールを列挙する必要があります。

備考

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー winuser.h (Windows.h を含む)

関連項目

概念

ダイアログ ボックス

HELPINFO の

LoadIcon の

MAKEINTRESOURCE を する

MAKELANGID を する

MessageBoxEx

MessageBoxIndirect

その他のリソース を する

リファレンス

WM_HELP