通过

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

指向以 null 结尾的字符串的指针，该字符串包含要显示在 ShellAbout 对话框标题栏中的文本，以及文本“Microsoft”后面的对话框的第一行。 如果文本包含分隔符（#），则函数会在标题栏中显示第一部分，第一行的第二部分位于文本“Microsoft”。

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 标头将 ShellAbout 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 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 中引入）