shellAboutA 函数 (shellapi.h)

显示 Shell About 对话框。

语法

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 的文本和默认图标。

若要查看 Shell“关于”对话框的示例,请从 Windows 资源管理器中的“帮助”菜单下拉列表中选择“关于 Windows”。

注意

shellapi.h 标头将 ShellAbout 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 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 中引入)