ListView_GetItem宏 (commctrl.h)

  • 项目

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

语法

void ListView_GetItem(
   hwnd,
   pitem
);

参数

hwnd

类型： HWND

列表视图控件的句柄。

pitem

类型： LPLVITEM

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

返回值

无

备注

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

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

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

要求

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