SHAppBarMessage函数检索 Windows 任务栏的边框

ABM_GETTASKBARPOS消息

检索 Windows 任务栏的边框。

C++复制

fResult = (BOOL) SHAppBarMessage(ABM_GETTASKBARPOS, pabd);

参数

pabd

指向 APPBARDATA 结构的指针，该结构的 rc 成员接收任务栏的边界矩形（以屏幕坐标表示）。 发送此消息时，必须指定 cbSize ;将忽略所有其他成员。

返回值

如果成功，则返回 TRUE ;否则为 FALSE。

备注

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

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Shellapi.h

appBARDATA 结构 (shellapi.h)

• 项目
• 2023/03/11

反馈

本文内容

1. 语法
2. 成员
3. 要求

包含有关系统应用栏消息的信息。

语法

C++复制

typedef struct _AppBarData {
  DWORD  cbSize;
  HWND   hWnd;
  UINT   uCallbackMessage;
  UINT   uEdge;
  RECT   rc;
  LPARAM lParam;
} APPBARDATA, *PAPPBARDATA;

成员

cbSize

类型：DWORD

结构大小（以字节为单位）。

hWnd

类型：HWND

应用栏窗口的句柄。 并非所有消息都使用此成员。 请参阅单个消息页，了解是否需要提供 hWind 值。

uCallbackMessage

类型： UINT

应用程序定义的消息标识符。 应用程序将指定的标识符用于发送到 由 hWnd 成员标识的应用栏的通知消息。 发送 ABM_NEW 消息时使用此成员。

uEdge

类型： UINT

一个 指定屏幕边缘的 值。 发送以下消息之一时使用此成员：

• ABM_GETAUTOHIDEBAR
• ABM_SETAUTOHIDEBAR
• ABM_GETAUTOHIDEBAREX
• ABM_SETAUTOHIDEBAREX
• ABM_QUERYPOS
• ABM_SETPOS

此成员可以是以下值之一。

ABE_BOTTOM

下边缘。

ABE_LEFT

左边缘。

ABE_RIGHT

右边缘。

ABE_TOP

上边缘。

rc

类型： RECT

RECT 结构，其用法因消息而异：

• ABM_GETTASKBARPOS、 ABM_QUERYPOSABM_SETPOS：应用栏或 Windows 任务栏的边框（以屏幕坐标表示）。
• ABM_GETAUTOHIDEBAREX，ABM_SETAUTOHIDEBAREX：正在其上执行操作的监视器。 可以通过 GetMonitorInfo 函数检索此信息。

lParam

类型： LPARAM

依赖于消息的值。 此成员用于以下消息：

• ABM_SETAUTOHIDEBAR
• ABM_SETAUTOHIDEBAREX
• ABM_SETSTATE

有关详细信息，请参阅各个消息页。

要求

最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	shellapi.h