ListView_SetItem info  Overview  Group

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

BOOL ListView_SetItem(

HWND hwnd,
const LV_ITEM FAR *pitem
);

Parameters

hwnd

Handle to the list view control.

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_SetItemText, LV_ITEM, LVM_SETITEM