ShellMessageBoxW 関数 (shellapi.h)

[ShellMessageBox は、[要件] セクションで指定したオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

ShellMessageBox は 、メッセージ ボックス のタイトルとして所有者ウィンドウのタイトルを使用するオプションを提供する MessageBox の特殊なインスタンスです。

構文

int ShellMessageBoxW(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCWSTR   lpcText,
  [in] LPCWSTR   lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

パラメーター

[in] hAppInst

種類: HINSTANCE

pszTitle で という名前の文字列リソースを読み込むモジュールのハンドル。 pszTitle で文字列リソースに名前が付かない場合、このパラメーターは無視されます。 pszMsg または pszTitle がリソース ID の場合、この値は有効である必要があります。

[in] hWnd

型: HWND

作成するメッセージ ボックスの所有者ウィンドウへのハンドル。 この変数が NULL でない場合は、所有者ウィンドウのタイトルがメッセージ ボックスのタイトルとして使用されます。

[in] lpcText

型: LPCTSTR

表示されるメッセージまたはメッセージの取得元を指定するリソース ID を含む null で終わる文字列へのポインター。

[in] lpcTitle

型: LPCTSTR

ダイアログ ボックスのタイトルまたはタイトルを取得する場所を指定するリソース ID を含む null で終わる文字列へのポインター。 このパラメーターと hWnd の両方が NULL の場合、タイトルは表示されません。 このパラメーターが MAKEINTRESOURCE マクロで形成された読み込み可能なリソースを指している場合は、 hWnd をタイトルとしてオーバーライドします。

[in] fuStyle

型: UINT

ダイアログ ボックスの内容と動作を指定します。 使用できる値については、「 MessageBox」を参照してください。

...

pszMsg と組み合わせて、メッセージ ボックスに表示されるフルテキストを形成する可変引数リスト。

戻り値

型: int

メッセージ ボックスで押されたボタンを示す整数値。 特定の値については、「 MessageBox」を参照してください。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

注意

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

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shellapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll

こちらもご覧ください

MAKEINTRESOURCE

メッセージ ボックス