ListView_GetGroupRect宏 (commctrl.h)

获取指定组的矩形。 使用此宏或显式发送 LVM_GETGROUPRECT 消息。

语法

BOOL ListView_GetGroupRect(
  [in]      HWND hwnd,
  [in]      int  iGroupId,
  [in]      LONG type,
  [in, out] RECT *prc
);

参数

[in] hwnd

类型:HWND

列表视图控件的句柄。

[in] iGroupId

类型:int

iGroupId 指定组(请参阅 LVGROUP 结构)。

[in] type

类型:LONG

指定要检索的矩形的类型。 此参数必须是下列值之一。

价值 意义
LVGGR_GROUP
整个展开组的坐标。
LVGGR_HEADER
标头的坐标(折叠组)。
LVGGR_LABEL
仅标签的坐标。
LVGGR_SUBSETLINK
仅子集链接的坐标(标记子集)。 列表视图控件可以限制每个组中显示的可见项数。 向用户显示一个链接,允许用户展开该组。 如果组是子集(组状态为LVGS_SUBSETED,请参阅结构 LVGROUP,成员 状态),则此标志将返回子集链接的边界矩形。 提供了此标志,以便辅助功能应用程序可以找到该链接。

[in, out] prc

类型:RECT*

指向 RECT 结构的指针,用于接收由 iGroupId指定的组的信息。 消息接收方负责设置结构成员,其中包含由 iGroupId指定的组的信息。 调用应用程序负责分配结构的内存。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h