如何使用状态映像索引

  • 项目

在树形视图控件中，如何设置和检索状态图像索引经常会引起混淆。 以下示例演示了设置和检索状态图像索引的正确方法。 这些示例假定树形视图控件中只有两个状态图像索引，即未选中和选中。 如果应用程序包含两个以上的函数，则需要修改这些函数才能处理这种情况。

需要了解的事项

技术

先决条件

  • C/C++
  • Windows 用户界面编程

说明

设置树形视图项目的检查状态

以下示例演示了如何设置树状视图项目的检查状态。

  BOOL TreeView_SetCheckState(HWND hwndTreeView, HTREEITEM hItem, BOOL fCheck)
  {
      TVITEM tvItem;

      tvItem.mask   = TVIF_HANDLE | TVIF_STATE;
      tvItem.hItem  = hItem;
      tvItem.stateMask  = TVIS_STATEIMAGEMASK;

      // Image 1 in the tree-view check box image list is the unchecked box. 
      // Image 2 is the checked box.

      tvItem.state = INDEXTOSTATEIMAGEMASK((fCheck ? 2 : 1));

      return TreeView_SetItem(hwndTreeView, &tvItem);
  }

检索树状视图项目的检查状态

以下示例演示了如何检索树状视图项目的检查状态。

  BOOL TreeView_GetCheckState(HWND hwndTreeView, HTREEITEM hItem)
  {
      TVITEM tvItem;

      // Prepare to receive the desired information.
      tvItem.mask   = TVIF_HANDLE | TVIF_STATE;
      tvItem.hItem  = hItem;
      tvItem.stateMask  = TVIS_STATEIMAGEMASK;

      // Request the information.
      TreeView_GetItem(hwndTreeView, &tvItem);

      // Return zero if it's not checked, or nonzero otherwise.
      return ((BOOL)(tvItem.state >> 12) - 1);
  }

使用树状视图控件

CustDTv 示例演示树状视图控件中的自定义绘图