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 マクロに渡される整数リソース識別子を指定できます。

システム定義の標準アイコンの 1 つを読み込むには、 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 ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MSGBOXPARAMS を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

概念

ダイアログ ボックス

HELPINFO

LoadIcon

MAKEINTRESOURCE

MAKELANGID

MessageBoxEx

MessageBoxIndirect

その他のリソース

リファレンス

Wm_help