shAppBarMessage 函数 (shellapi.h)
向系统发送应用栏消息。
语法
UINT_PTR SHAppBarMessage(
[in] DWORD dwMessage,
[in, out] PAPPBARDATA pData
);
参数
[in] dwMessage
类型：DWORD
要发送的应用栏消息值。 此参数的取值可为下列值之一：
ABM_NEW (0x00000000)
注册新的应用栏，并指定系统应该用来向应用栏发送通知消息的消息标识符。
ABM_REMOVE (0x00000001)
注销应用栏，从系统的内部列表中删除该栏。
ABM_QUERYPOS (0x00000002)
请求应用栏的大小和屏幕位置。
ABM_SETPOS (0x00000003)
设置应用栏的大小和屏幕位置。
ABM_GETSTATE (0x00000004)
检索 Windows 任务栏的自动隐藏和始终处于顶部状态。
ABM_GETTASKBARPOS (0x00000005)
检索 Windows 任务栏的边框。 请注意，这仅适用于系统任务栏。 其他对象（尤其是第三方软件提供的工具栏）也可以存在。 因此，用户可能无法看到 Windows 任务栏未覆盖的某些屏幕区域。 若要检索任务栏和其他应用栏未覆盖的屏幕区域（应用程序可用的工作区），请使用 GetMonitorInfo 函数。
ABM_ACTIVATE (0x00000006)
通知系统激活或停用应用栏。 pData 指向的 APPBARDATA 的 lParam 成员设置为 TRUE 以激活，或设置为 FALSE 以停用。
ABM_GETAUTOHIDEBAR (0x00000007)
检索与屏幕的特定边缘关联的自动隐藏应用栏的句柄。
ABM_SETAUTOHIDEBAR (0x00000008)
注册或注销屏幕边缘的自动隐藏应用栏。
ABM_WINDOWPOSCHANGED (0x00000009)
当应用栏的位置发生更改时，通知系统。
ABM_SETSTATE (0x0000000A)
Windows XP 及更高版本： 设置应用栏的自动隐藏和 Always-on-top 属性的状态。
ABM_GETAUTOHIDEBAREX (0x0000000B)
Windows XP 及更高版本： 检索与特定监视器的特定边缘关联的自动隐藏应用栏的句柄。
ABM_SETAUTOHIDEBAREX (0x0000000C)
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 () |