TreeView_SetCheckState macro

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 hItem,
   BOOL      fCheck
);

Parameters

hwndTV

Type: HWND

Handle to the tree-view control.

hItem

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

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

 

 

Show: