通过

ListView_GetItem宏 （commctrl.h）

  • 项目

获取列表视图项的一些或全部属性。 可以使用此宏或显式发送 LVM_GETITEM 消息。

语法

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

参数

hwnd

类型：HWND

列表视图控件的句柄。

pitem

类型：LPLVITEM

指向 LVITEM 结构的指针，该结构指定要检索和接收有关列表视图项的信息。

返回值

类型：BOOL

如果成功，则返回 TRUE;否则返回 FALSE。

言论

发送 LVM_GETITEM 消息时，iItem 和 iSubItem 成员标识要检索的项或子项，掩码 成员指定要检索的属性。 有关可能值的列表，请参阅 LVITEM 结构的说明。

如果在 LVITEM 结构的 掩码 成员中设置LVIF_TEXT标志，pszText 成员必须指向有效的缓冲区，并且 cchTextMax 成员必须设置为该缓冲区中的字符数。 应用程序不应假定文本必须放置在指定的缓冲区中。 控件可以改为更改结构 pszText 成员指向新文本，而不是将其放置在缓冲区中。

如果 掩码 成员指定LVIF_STATE值，则 stateMask 成员必须指定要检索的项状态位。 在输出中，状态 成员包含指定状态位的值。

要求

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