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

最新推荐文章于 2025-11-22 12:47:32 发布

原创最新推荐文章于 2025-11-22 12:47:32 发布 · 392 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#windows

Visual Studio 专栏收录该内容

128 篇文章

订阅专栏

ABM_GETTASKBARPOS是一个用于获取Windows任务栏边框矩形的消息，通过SHAppBarMessage函数发送。参数包括一个APPBARDATA结构指针，其rc成员接收任务栏边界。返回值为操作是否成功。该消息仅适用于系统任务栏，不考虑第三方工具栏。要获取不受任务栏覆盖的屏幕区域，可以使用GetMonitorInfo函数。

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

反馈

本文内容

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

语法

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

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

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

ABE_BOTTOM

下边缘。

ABE_LEFT

左边缘。

ABE_RIGHT

右边缘。

ABE_TOP

上边缘。

rc

类型： RECT

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

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

lParam

类型： LPARAM

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

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