ListView_GetGroupRect 宏 (commctrl.h)

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

语法

void ListView_GetGroupRect(
  [in]       hwnd,
  [in]       iGroupId,
  [in]       type,
  [in, out]  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 指定的组的信息设置结构成员。 调用应用程序负责为 结构分配内存。

返回值

要求

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