Edit

Share via

ListView_GetCheckState macro (commctrl.h)

  • Article

Determines if an item in a list-view control is selected. This should be used only for list-view controls that have the LVS_EX_CHECKBOXES style.

Syntax

BOOL ListView_GetCheckState(
   HWND hwndLV,
   UINT i
);

Parameters

hwndLV

Type: HWND

A handle to a list-view control.

i

Type: UINT

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

Return value

Type: BOOL

Returns nonzero if the given item is selected, or zero otherwise. If this macro is applied to a list-view control that does not have check boxes enabled, the return value is not reliable.

Requirements

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