ShellAboutA 関数 (shellapi.h)

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

構文

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

要件

サポートされている最小のクライアント	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 で導入)