CTreeCtrl(树状控件)用法源代码

CTreeCtrl是MFC（Microsoft Foundation Classes）库中提供的一种控件，用于在Windows应用程序中创建和管理树形视图。这种控件常用于显示层级结构的数据，如文件系统、组织结构或菜单。本篇文章将深入探讨CTreeCtrl的用法，包括其基本概念、功能、API接口以及如何在实际应用中进行操作。 ### 基本概念 CTreeCtrl是基于Windows API中的`HTREEITEM`类型的树控件。它允许用户通过添加、删除、选择和展开节点来交互。每个节点可以有子节点，形成一个树形结构。 ### 创建CTreeCtrl 创建CTreeCtrl通常是在对话框类的构造函数中进行，使用`Create`成员函数： ```cpp m_tree.Create(WS_VISIBLE | WS_CHILD | TVS_HASBUTTONS | TVS_HASLINES, rect, this, IDC_TREECTRL); ``` 这里，`rect`是控件的矩形区域，`this`表示父窗口，`IDC_TREECTRL`是控件的ID。 ### 添加节点 添加节点使用`InsertItem`函数，例如： ```cpp TVINSERTSTRUCT tvis; tvis.hParent = TVI_ROOT; // 如果是根节点 tvis.hInsertAfter = TVI_LAST; // 插入到末尾 tvis.item.pszText = _T("节点文本"); // 节点文本 tvis.item.iImage = 0; // 图标索引 tvis.item.iSelectedImage = 0; // 选中时的图标索引 HTREEITEM hNode = m_tree.InsertItem(&tvis); ``` ### 管理节点 你可以使用以下函数来管理树中的节点： - `GetSelection()`：获取当前选中的节点。 - `SelectItem(HTREEITEM)`：选择指定的节点。 - `Expand(HTREEITEM, int)`：展开或折叠节点，参数`int`可以是`TVE_EXPAND`, `TVE_COLLAPSE`, `TVE_TOGGLE`。 - `DeleteItem(HTREEITEM)`：删除指定的节点。 ### 事件处理 为了响应用户的操作，如点击、展开节点，需要添加消息映射和处理函数。例如，添加`ON_NOTIFY`消息映射以处理`TVN_SELCHANGED`事件： ```cpp BEGIN_MESSAGE_MAP(CMyDialog, CDialogEx) ON_NOTIFY(TVN_SELCHANGED, IDC_TREECTRL, OnTvnSelchangedTreeCtrl) END_MESSAGE_MAP() void CMyDialog::OnTvnSelchangedTreeCtrl(NMHDR* pNMHDR, LRESULT* pResult) { NMTREEVIEW* pNMTreeView = reinterpret_cast<NMTREEVIEW*>(pNMHDR); HTREEITEM hSel = pNMTreeView->itemNew.hItem; // 处理选中项变化的逻辑 } ``` ### 使用图标 CTreeCtrl可以显示图标，需要设置图像列表并关联到控件： ```cpp CImageList imageList; imageList.Create(16, 16, ILC_COLOR32, 2, 2); // 创建图像列表 // 加载图标资源 imageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1), RGB(0, 0, 0)); imageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2), RGB(0, 0, 0)); m_tree.SetImageList(&imageList, TVSIL_NORMAL); ``` ### 子类化CTreeCtrl 在某些情况下，可能需要直接处理控件的消息，这可以通过子类化控件来实现： ```cpp m_tree.SubclassDlgItem(IDC_TREECTRL, this); ``` ### 示例：`combotree` `combotree`可能是指一个组合了树形控件和下拉列表框的控件，这种控件结合了CTreeCtrl和CComboBox的功能。在实际项目中，可能会用这样的控件来展示一组可选择的分类，每个分类下有多个子项。 总结，CTreeCtrl是MFC中用于构建树形视图的强大工具，能够方便地处理层级数据。通过熟练掌握它的API和事件处理，可以创建出用户友好的界面，提高应用程序的用户体验。在实际开发中，可以根据需求扩展其功能，例如添加自定义数据、实现拖放操作等。