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_QUERYPOSABM_SETPOS:应用栏或 Windows 任务栏的边框(以屏幕坐标表示)。
- ABM_GETAUTOHIDEBAREX,ABM_SETAUTOHIDEBAREX:正在其上执行操作的监视器。 可以通过 GetMonitorInfo 函数检索此信息。
lParam
类型: LPARAM
依赖于消息的值。 此成员用于以下消息:
有关详细信息,请参阅各个消息页。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
标头 | shellapi.h |