shAppBarMessage 函数 (shellapi.h)

向系统发送应用栏消息。

语法

UINT_PTR SHAppBarMessage(
  [in]      DWORD       dwMessage,
  [in, out] PAPPBARDATA pData
);

[in] dwMessage

类型：DWORD

要发送的应用栏消息值。此参数的取值可为下列值之一：

注册新的应用栏，并指定系统应该用来向应用栏发送通知消息的消息标识符。

注销应用栏，从系统的内部列表中删除该栏。

请求应用栏的大小和屏幕位置。

设置应用栏的大小和屏幕位置。

检索 Windows 任务栏的自动隐藏和始终处于顶部状态。

检索 Windows 任务栏的边框。请注意，这仅适用于系统任务栏。其他对象（尤其是第三方软件提供的工具栏）也可以存在。因此，用户可能无法看到 Windows 任务栏未覆盖的某些屏幕区域。若要检索任务栏和其他应用栏未覆盖的屏幕区域（应用程序可用的工作区），请使用 GetMonitorInfo 函数。

通知系统激活或停用应用栏。 pData 指向的 APPBARDATA 的 lParam 成员设置为 TRUE 以激活，或设置为 FALSE 以停用。

检索与屏幕的特定边缘关联的自动隐藏应用栏的句柄。

注册或注销屏幕边缘的自动隐藏应用栏。

当应用栏的位置发生更改时，通知系统。

Windows XP 及更高版本： 设置应用栏的自动隐藏和 Always-on-top 属性的状态。

Windows XP 及更高版本： 检索与特定监视器的特定边缘关联的自动隐藏应用栏的句柄。

Windows XP 及更高版本： 为特定监视器的边缘注册或注销自动隐藏应用栏。

[in, out] pData

类型： PAPPBARDATA

指向 APPBARDATA 结构的指针。进入和退出时结构的内容取决于 dwMessage 参数中设置的值。有关具体信息，请参阅各个邮件页面。

类型： UINT_PTR

此函数返回一个依赖于消息的值。有关详细信息，请参阅发送的特定应用栏消息Windows SDK文档。 “另请参阅”部分提供了指向这些文档的链接。

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shellapi.h
Library	Shell32.lib
DLL	Shell32.dll (版本 4.0 或更高版本)
API 集	Windows 10版本 10.0.10240 中引入的 ext-ms-win-shell-shell32-l1-2-1 ()