ListView_SetItem 宏 (commctrl.h)

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

语法

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

pitem

类型:const LPLVITEM

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

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

若要设置列表视图项的属性,请将 LVITEM 结构的 iItem 成员设置为项的索引,并将 iSubItem 成员设置为零。 对于项,可以使用 状态pszTextiImagelParamLVITEM 结构的成员来修改这些项目参数。

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

要求

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