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 |