LVM_SETITEMSTATE message

Changes the state of an item in a list-view control. You can send this message explicitly or by using the ListView_SetItemState macro.

Parameters

wParam

Index of the list-view item. If this parameter is -1, then the state change is applied to all items.

lParam

Pointer to an LVITEM structure. The stateMask member specifies which state bits to change, and the state member contains the new values for those bits. The other members are ignored.

Return value

If you send this message explicitly, it returns TRUE if successful or FALSE otherwise.

Remarks

An item's state value includes a set of bit flags that indicate the item's state. The state value can also include image list indexes that indicate the item's state image and overlay image.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h