ListView_SetItem宏 (commctrl.h)
设置列表视图项的部分或全部属性。 还可以使用 ListView_SetItem 设置子项的文本。 可以使用此宏或显式发送 LVM_SETITEM 消息。
语法
void ListView_SetItem(
hwnd,
pitem
);
参数
hwnd
类型: HWND
列表视图控件的句柄。
pitem
类型: const LPLVITEM
指向包含新项属性的 LVITEM 结构的指针。 iItem 和 iSubItem 成员标识项或子项,掩码成员指定要设置的属性。 如果 掩码 成员指定LVIF_TEXT值, 则 pszText 成员是以 null 结尾的字符串的地址,而 cchTextMax 成员将被忽略。 如果 掩码 成员指定LVIF_STATE值, 则 stateMask 成员指定要更改的项状态,并且 状态 成员包含这些状态的值。
返回值
无
备注
若要设置列表视图项的属性,请将 LVITEM 结构的 iItem 成员设置为项的索引,并将 iSubItem 成员设置为零。 对于项,可以使用 LVITEM 结构的 state、pszText、iImage 和 lParam 成员来修改这些项目参数。
若要设置子项的文本,请将 iItem 和 iSubItem 成员设置为指示特定子项,并使用 pszText 成员指定文本。 或者,可以使用 ListView_SetItemText 宏来设置子项的文本。 不能为子项设置 状态 或 lParam 成员,因为子项没有这些属性。 在版本 4.70 及更高版本中,可以设置子项的 iImage 成员。 如果列表视图控件具有 LVS_EX_SUBITEMIMAGES 扩展样式,则将显示子项图像。 以前的版本将忽略子项映像。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | commctrl.h |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈