TreeView_SetCheckState macro (commctrl.h)

Sets the item's state image to "checked" or "unchecked." You can also use the TVM_SETITEM message directly.

Syntax

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

Parameters

hwndTV

Type: HWND

Handle to the tree-view control.

hti

Type: HTREEITEM

Handle to the item.

fCheck

Type: BOOL

Value that indicates which state image is displayed. Set fCheck to TRUE to display the checked state image or FALSE to display the unchecked image.

Return value

None

Remarks

A tree-view control can have two image lists. The normal image list stores the selected, nonselected, and overlay images. Check boxes are stored in the state image list and displayed to the left of the corresponding normal image. State images are specified by a one-based index. An index of zero indicates that there is no state image. See Tree-View Image Lists for a discussion of how to handle tree-view images.

If you want to define your own state images, this macro assumes that the checked and unchecked images have the same indexes as the standard image list: 1 for unchecked and 2 for checked.

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