LVM_SETITEM消息

  • 项目

设置列表视图项的部分或全部属性。 还可以发送LVM_SETITEM来设置子项的文本。 可以显式发送此消息，也可以使用 ListView_SetItem 宏发送。

参数

wParam

必须为零。

lParam

指向包含新项属性的 LVITEM 结构的指针。 iItem 和 iSubItem 成员标识项或子项，掩码成员指定要设置的属性。 如果 掩码 成员指定LVIF_TEXT值， 则 pszText 成员是以 null 结尾的字符串的地址，而 cchTextMax 成员将被忽略。 如果 掩码 成员指定LVIF_STATE值， 则 stateMask 成员指定要更改的项状态， 并且状态 成员包含这些状态的值。

返回值

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

备注

若要设置列表视图项的属性，请将 LVITEM 结构的 iItem 成员设置为项的索引，并将 iSubItem 成员设置为零。 对于项，可以设置 LVITEM 结构的状态、pszText、iImage 和 lParam 成员。

若要设置子项的文本，请将 iItem 和 iSubItem 成员设置为指示特定子项，并使用 pszText 成员指定文本。 或者，可以使用 ListView_SetItemText 宏来设置子项的文本。 不能为子项设置 状态 或 lParam 成员，因为子项没有这些属性。 在版本 4.70 及更高版本中，可以设置子项的 iImage 成员。 如果列表视图控件具有 LVS_EX_SUBITEMIMAGES 扩展样式，则将显示子项图像。 以前的版本将忽略子项映像。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2003 [仅限桌面应用]
标头
Commctrl.h
Unicode 和 ANSI 名称
 LVM_SETITEMW (Unicode) 和 LVM_SETITEMA (ANSI)