TreeView_SetCheckState macro (commctrl.h)

Article
10/23/2024

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

Syntax

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      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

Type: UINT

The return value is not used.

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

Share via