Selects or deselects an item in a list-view control. You can use this macro or send the LVM_SETITEMSTATE message explicitly.

Syntax

ListView_SetCheckState(

    HWND hwndLV,
    UINT iIndex,
    BOOL fCheck
);

Parameters

hwndLV

A handle to a list-view control.

iIndex

The index of the item for which to set the check state.

fCheck

A value that is set to TRUE to select the item, or FALSE to deselect it.

Return Value

No return value.

Remarks

This macro should only be used for list-view controls with the LVS_EX_CHECKBOXES style. Although the LVM_SETITEMSTATE message used by ListView_SetCheckState is found on Microsoft Windows 95 and later systems, the LVS_EX_CHECKBOXES style was not introduced until version 4.70 of the common controls.

Macro Information

Minimum DLL Version	comctl32.dll version 4.70 or later
Header	commctrl.h
Minimum operating systems	Windows 2000, Windows NT 4.0 with Internet Explorer 3.0, Windows 98, Windows 95 with Internet Explorer 3.0

See Also

ListView_SetItemState