ShellMessageBoxA 関数 (shellapi.h)

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

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

構文

int ShellMessageBoxA(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCSTR    lpcText,
  [in] LPCSTR    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 を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

MAKEINTRESOURCE

メッセージ ボックス