ShellAboutW 関数 (shellapi.h)

[ ShellAbout ] ダイアログ ボックスを表示します。

構文

INT ShellAboutW(
  [in, optional] HWND    hWnd,
  [in]           LPCWSTR szApp,
  [in, optional] LPCWSTR szOtherStuff,
  [in, optional] HICON   hIcon
);

パラメーター

[in, optional] hWnd

型: HWND

親ウィンドウへのウィンドウ ハンドル。 このパラメーターは、NULL でもかまいません。

[in] szApp

型: LPCTSTR

[ShellAbout] ダイアログ ボックスのタイトル バーと、テキスト "Microsoft" の後のダイアログ ボックスの最初の行に表示されるテキストを含む null で終わる文字列へのポインター。 テキストに 2 つの部分に分割された区切り記号 (#) が含まれている場合、関数はタイトル バーの最初の部分と、テキスト "Microsoft" の後の最初の行の 2 番目の部分を表示します。

Windows 2000、Windows XP、Windows Server 2003: このパラメーターが指す文字列に区切り記号 (#) が含まれている場合は、文字列を書き込み可能にする必要があります。

Windows Vista、Windows Server 2008: この文字列の長さは 200 文字以内です。 #区切り記号がない限り、 szApp の内容は "Microsoft" の後に表示されなくなります。この場合、 # の後の部分は最初の行を完全に置き換えます。

[in, optional] szOtherStuff

型: LPCTSTR

バージョンと著作権情報の後のダイアログ ボックスに表示されるテキストを含む null で終わる文字列へのポインター。 このパラメーターは、NULL でもかまいません。

[in, optional] hIcon

種類: HICON

ダイアログ ボックスに関数が表示するアイコンのハンドル。 このパラメーターには NULL を指定できます。この場合、関数は Windows アイコンを表示します。

戻り値

型: int

成功した場合は TRUE。それ以外の場合は FALSE。

注釈

[ShellAbout 関数] ダイアログ ボックスでは、テキストと Windows に固有の既定のアイコンが使用されることに注意してください。

[ShellAbout] ダイアログ ボックスの例を表示するには、Windows エクスプローラーの [ヘルプ] メニュー ドロップダウン リストから [Windows について] を選択します。

注意

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

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shellapi.h
Library	Shell32.lib
[DLL]	Shell32.dll (バージョン 3.51 以降)
API セット	ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)