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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shellapi.h
ライブラリ	Shell32.lib
DLL	Shell32.dll (バージョン 3.51 以降)
API セットの	ext-ms-win-shell-shell32-l1-2-2 (Windows 10 バージョン 10.0.14393 で導入)