TreeView_SetCheckState 宏（commctrl.h）

将项的状态图像设置为“已选中”或“未选中”。还可以直接使用 TVM_SETITEM 消息。

语法

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

hwndTV

类型：HWND

树视图控件的句柄。

hti

类型：HTREEITEM

项的句柄。

fCheck

类型：BOOL

指示显示哪个状态图像的值。将 fCheck 设置为 TRUE 以显示选中状态图像，或 FALSE 显示未选中的图像。

类型：UINT

不使用返回值。

树视图控件可以有两个图像列表。普通图像列表存储所选图像、未选择图像和覆盖图像。复选框存储在状态图像列表中，并显示在相应普通图像的左侧。状态映像由基于一个的索引指定。零的索引指示没有状态图像。有关如何处理树视图图像的讨论，请参阅 Tree-View 图像列表。

如果要定义自己的状态映像，则此宏假定已选中和未选中的图像具有相同的标准映像列表的索引：1 表示未选中，2 用于选中。