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:

PICList 2025 contributors: o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr.

  .