树控件教程超详细（建议边看边做，加深理解，做一遍，顶看五遍，还不费劲）

最新推荐文章于 2025-05-10 15:01:33 发布

智慧的搬运工

最新推荐文章于 2025-05-10 15:01:33 发布

阅读量896

点赞数

分类专栏： VC控件

VC控件专栏收录该内容

3 篇文章

订阅专栏

本文详细介绍了MFC中树控件（CTreeCtrl类）的创建与使用方法，包括树控件的基本概念、创建与设置步骤、节点的插入与图标设置、状态修改及遍历方法，还讲解了树控件的消息处理过程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

来源：1）http://blog.youkuaiyun.com/tengxiaoming/article/details/5643654 2）http://huigezrx.blog.163.com/blog/static/321016522009113085322738/

一、树控件的基本概念

树形控件是一种可以分级显示项目列表的窗口，其所含项目以相互关联的方式显示在控件中，通过点击位于某个层次的项目节点可以展开下一层次中从属于该节点的所有项目。树形控件非常适合于管理那些层次较多且相互间隶属关系较为清晰的项目元素。在MFC中，由 CTreeCtrl类提供了对树形控件的功能支持。

在用Create（）创建了一个树形控件后可以用SetImageList（）函数为其设置一个图象列表，这样就可以在树形控件中为各个层次的项目设置图标。通过InsertItem（）函数可以为其添加数据项，返回的 HTREEITEM类型的句柄唯一标识了此添加的项目。该句柄应当妥善保管，只有通过该句柄才能为此项目继续添加子项目。如果在创建子窗口时指定父窗口句柄为NULL，则将直接在根目录创建项目。

二、树控件的创建与设置详解

（1）创建树控件

树形控件可以用于树形的结构，其中有一个根接点(Root)然后下面有许多子结点，而每个子结点上可以有子节点，也可以没有。MFC中使用CTreeCtrl类来封装树形控件的各种操作。通过调用 Create创建。

BOOL Create( DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID );

dwStyle：设置树控件的风格样式。

TVS_HASLINES 在父/子结点之间绘制连线

TVS_LINESATROOT 在根/子结点之间绘制连线

TVS_HASBUTTONS 在每一个结点前添加一个按钮，用于表示当前结点是否已被展开

TVS_EDITLABELS 结点的显示字符可以被编辑

TVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点

TVS_DISABLEDRAGDROP 不允许Drag/Drop

TVS_NOTOOLTIPS 不使用ToolTip显示结点的显示字符

rect：指定树视图控件的大小和位置。它可以是 CRect 对象或 Rect 结构。

pParentWnd：指定树视图控件的父窗口，通常 CDialog。不能为 NULL。

nID：指定树视图控件的ID.

返回：非零，如果初始化成功;否则为0。

在树形控件中每一个结点都有一个句柄（HTREEITEM），同时添加结点时必须提供的参数是该结点的父结点句柄，（其中根Root结点只有一个，既不可以添加也不可以删除）

（2）插入节点

在树形控件中每一个结点都有一个句柄（HTREEITEM），同时添加结点时必须提供的参数是该结点的父结点句柄，（其中根Root结点只有一个，既不可以添加也不可以删除）利用

HTREEITEM InsertItem( LPCTSTR lpszItem, HTREEITEM hParent = TVI_ROOT, HTREEITEM hInsertAfter = TVI_LAST );可以添加一个结点。

pszItem：显示的字符。

hParent：代表父结点的句柄。

hInsertAfter:插入的节点，会排在这个节点的后边。

返回值：当前创建的结点的句柄。

下面的代码会建立一个如下形式的树形结构：

+--- Parent1

+--- Child1_1

+--- Child1_2

+--- Child1_3

+--- Parent2

+--- Parent3

//-------------------------------------------------------start------------------------------------------------------------------------------------------------------------------

HTREEITEM hItem,hSubItem;

hItem = m_tree.InsertItem("Parent1",TVI_ROOT);//在根结点上添加Parent1

hSubItem = m_tree.InsertItem("Child1_1",hItem);//在Parent1上添加一个子结点

hSubItem = m_tree.InsertItem("Child1_2",hItem,hSubItem);//在Parent1上添加一个子结点，排在Child1_1后面

hSubItem = m_tree.InsertItem("Child1_3",hItem,hSubItem);

hItem = m_tree.InsertItem("Parent2",TVI_ROOT,hItem);

hItem = m_tree.InsertItem("Parent3",TVI_ROOT,hItem);

//------------------------------------------------------end----------------------------------------------

(3)设置结点前缀图标

如果你希望在每个结点前添加一个小图标，就必需先调用CImageList* SetImageList( CImageList * pImageList, int nImageListType );指明当前所使用的ImageList，nImageListType为TVSIL_NORMAL。在调用完成后控件中使用图片以设置的ImageList中图片为准。然后调用

HTREEITEM InsertItem( LPCTSTR lpszItem,int nImage, int nSelectedImage, HTREEITEM hParent = TVI_ROOT, HTREEITEM hInsertAfter = TVI_LAST);添加结点，nImage为结点没被选中时所使用图片序号，nSelectedImage为结点被选中时所使用图片序号。下面的代码演示了ImageList的设置。

//-------------------------------------------------------start------------------------------------------------------------------------------------------------------------

m_list.Create(IDB_TREE,16,4,RGB(0,0,0));

m_tree.SetImageList(&m_list,TVSIL_NORMAL);

m_tree.InsertItem("Parent1",0,1);//添加，选中时显示图标1，未选中时显示图标0

//--------------------------------------------------------end--------------------------------------------------------

(4)修改控件状态

HTREEITEMGetSelectedItem( );//将返回当前选中的结点的句柄。

BOOLSelectItem( HTREEITEM hItem ); //将选中指明结点。

BOOLGetItemImage( HTREEITEM hItem, int& nImage, int& nSelectedImage )//得到指定结点的图标索引

BOOLSetItemImage( HTREEITEM hItem, int nImage, int nSelectedImage )//修改某结点所使用图标索引。

CStringGetItemText( HTREEITEM hItem )//得到指定结点的显示字符

BOOLSetItemText( HTREEITEM hItem, LPCTSTR lpszItem );//修改某一结点的显示字符。

BOOLDeleteItem( HTREEITEM hItem );//用于删除某一结点

BOOLDeleteAllItems( );//将删除所有结点。

（5）树控件的遍历

HTREEITEM GetRootItem( ); //得到根结点。

HTREEITEM GetChildItem( HTREEITEM hItem ); //得到子结点。

HTREEITEM GetPrevSiblingItem/GetNextSiblingItem( HTREEITEM hItem );//得到指明结点的上/下一个兄弟结点。

HTREEITEM GetParentItem( HTREEITEM hItem ); //得到父结点。

三、树控件的消息

树形控件的消息映射使用ON_NOTIFY宏，形式如同：ON_NOTIFY( wNotifyCode, id, memberFxn )，

wNotifyCode为通知代码（如单击树，双击树等），id为产生该消息的窗口ID，memberFxn为处理函数，

函数的原型如同void OnXXXTree(NMHDR* pNMHDR, LRESULT* pResult)，其中pNMHDR为一数据结构，在具体使用时需要转换成其他类型的结构。对于树形控件可能取值和对应的数据结构为：

TVN_SELCHANGED 在所选中的结点发生改变后发送，所用结构：NMTREEVIEW

TVN_ITEMEXPANDED 在某结点被展开后发送，所用结构：NMTREEVIEW

TVN_BEGINLABELEDIT 在开始编辑结点字符时发送，所用结构：NMTVDISPINFO

TVN_ENDLABELEDIT 在结束编辑结点字符时发送，所用结构：NMTVDISPINFO

TVN_GETDISPINFO 在需要得到某结点信息时发送，（如得到结点的显示字符）所用结构：NMTVDISPINFO

关于ON_NOTIFY有很多内容,可以参照MSDN

1、关于动态提供，结点所显示的字符：

（1）首先你在添加结点时需要指明lpszItem参数为：LPSTR_TEXTCALLBACK。在控件显示该结点时会通过发送TVN_GETDISPINFO来取得所需要的字符。（2）在处理该消息时先将参数pNMHDR转换为LPNMTVDISPINFO，然后填充其中 item.pszText。

但是我们通过什么来知道该结点所对应的信息呢，我的做法是在添加结点后设置其lParam参数，然后在提供信息时利用该参数来查找所对应的信息。下面的代码说明了这种方法：

//---------------------------------------------------------start------------------------------------------------------------------------------------------

char szOut[8][3]={"No.1","No.2","No.3"};

//添加结点

HTREEITEM hItem = m_tree.InsertItem(LPSTR_TEXTCALLBACK,...)

m_tree.SetItemData(hItem, 0 );

hItem = m_tree.InsertItem(LPSTR_TEXTCALLBACK,...)

m_tree.SetItemData(hItem, 1 );

//处理消息

void CParentWnd::OnGetDispInfoTree(NMHDR* pNMHDR, LRESULT* pResult)

{

TV_DISPINFO* pTVDI = (TV_DISPINFO*)pNMHDR;

pTVDI->item.pszText=szOut[pTVDI->item.lParam];//通过lParam得到需要显示的字符在数组中的位置

*pResult = 0;

}

//---------------------------------------------------------end----------------------------------------------

2、编辑结点的显示字符

首先需要设置树形控件的TVS_EDITLABELS风格，在开始编辑时该控件将会发送TVN_BEGINLABELEDIT，你可以通过在处理函数中返回TRUE来取消接下来的编辑，在编辑完成后会发送TVN_ENDLABELEDIT，在处理该消息时需要将参数pNMHDR转换为LPNMTVDISPINFO，然后通过其中的item.pszText得到编辑后的字符，并重置显示字符。如果编辑在中途中取消则该变量为NULL。下面的代码说明如何处理这些消息：

//处理消息 TVN_BEGINLABELEDIT

void CParentWnd::OnBeginEditTree(NMHDR* pNMHDR, LRESULT* pResult)

{

TV_DISPINFO* pTVDI = (TV_DISPINFO*)pNMHDR;

if(pTVDI->item.lParam==0);//判断是否取消该操作

*pResult = 1;

else

*pResult = 0;

}

//处理消息 TVN_BEGINLABELEDIT

void CParentWnd::OnBeginEditTree(NMHDR* pNMHDR, LRESULT* pResult)

{