LVM_SETITEM Overview  Group

The LVM_SETITEM message sets some or all of a list view item’s attributes. You can also send LVM_SETITEM to set the text of a subitem. You can send this message explicitly or by using the ListView_SetItem macro.

LVM_SETITEM 

wParam = 0; 

lParam = (LPARAM) (const LV_ITEM FAR *) pitem; 

 

Parameters

pitem

Pointer to an LV_ITEM structure that contains the new item attributes. The iItem and iSubItem members identify the item or subitem, and the mask member specifies which attributes to set.

If the mask member specifies the LVIF_TEXT value, the pszText member is the pointer to a null-terminated string and the cchTextMax member is ignored.

If the mask member specifies the LVIF_STATE value, the stateMask member specifies which item states to change and the state member contains the values for those states.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

To set the attributes of a list-view item, set the iItem member of the LV_ITEM structure to the index of the item; set the iSubItem member to zero. For an item, you can set the state, pszText, iImage, and lParam members of the LV_ITEM structure.

To set the text of a subitem, set the iItem and iSubItem members to indicate the specific subitem, and use the pszText member to specify the text. Alternatively, you can use the ListView_SetItemText macro to set the text of a subitem. You cannot set the state, iImage, or lParam members for subitems, because subitems do not have these attributes.

See Also

ListView_SetItem, ListView_SetItemText, LV_ITEM 

Comments: