ListView_GetItemIndexRect 宏 (commctrl.h)

获取指定列表视图控件当前视图中子项的所有或部分的边界矩形。 使用此宏或显式发送 LVM_GETITEMINDEXRECT 消息。

语法

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

参数

[in] hwnd

类型:HWND

列表视图控件的句柄。

[in] plvii

类型:LVITEMINDEX*

指向子项父项的 LVITEMINDEX 结构的指针。 调用方负责分配此结构并设置其成员。 plvii 不得 NULL

[in] iSubItem

类型:LONG

子项的索引。

[in] code

类型:LONG

要为其检索边界矩形的列表视图子项的一部分。 此参数必须是下列值之一。

价值 意义
LVIR_BOUNDS
返回整个子项的边界矩形,包括图标和标签。
LVIR_ICON
返回子项的图标或小图标的边框。
LVIR_LABEL
返回子项文本的边界矩形。

[in, out] prc

类型:LPRECT

指向 RECT 结构的指针,用于接收坐标。 调用方负责分配此结构。 不得 NULL

返回值

类型:BOOL

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

言论

如果 iSubItem 为零,则此宏将矩形的坐标返回到由 plvii指向的项。 不支持参数 代码 的值LVIR_SELECTBOUNDS。

要求

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