CTreeCtrl控件

1 简介

      树视图控件能够按层次结构组织和管理数据，通常用于显示树状结构数据。树视图控件以节点为单位显示数据，每一个节点（根节点除外）可以有一个父节点，多个子节点，这样便形成了一个阶梯型的树状结构。MFC中使用CTreeCtrl类来封装树形控件的各种操作。

 

2 创建过程

2.1 创建窗口

     通过调用
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显示结点的显示字符

 

2.2 添加节点 

 

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

     pszItem为显示的字符；

     hParent代表父结点的句柄，当前添加的结点会排在hInsertAfter表示的结点的后面，返回值为当前创建的结点的句柄；

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

例子：建立一个如下形式的树形结构：
+--- Parent1
      +--- Child1_1
      +--- Child1_2
      +--- Child1_3
+--- Parent2
+--- Parent3

 

代码如下：

/*假设m_tree为一个CTreeCtrl对象，而且该窗口已经创建*/
HTREEITEM hItem,hSubItem;

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

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

//在根结点上添加Parent2 and Parent3

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

 

2.3 常用函数

2.3.1 得到/修改控件的状态

HTREEITEM GetSelectedItem( )：将返回当前选中的结点的句柄；

BOOL SelectItem( HTREEITEM hItem )：将选中指明结点；

BOOL GetItemImage( HTREEITEM hItem, int& nImage, int& nSelectedImage ) ：得到某节点所使用图标索引；

BOOL SetItemImage( HTREEITEM hItem, int nImage, int nSelectedImage )：修改某结点所使用图标索引；
CString GetItemText( HTREEITEM hItem ) ：得到某一节点的显示字符；

BOOL SetItemText( HTREEITEM hItem, LPCTSTR lpszItem )：修改某一结点的显示字符；
BOOL DeleteItem( HTREEITEM hItem )：用于删除某一结点；

BOOL DeleteAllItems( )：删除所有结点；

 

2.3.2 遍历树

HTREEITEM GetRootItem( ):得到根结点;
HTREEITEM GetChildItem( HTREEITEM hItem ):得到子结点;
HTREEITEM GetPrevSiblingItem/GetNextSiblingItem( HTREEITEM hItem ):得到指明结点的上/下一个兄弟结点;
HTREEITEM GetParentItem( HTREEITEM hItem ):得到父结点;

 

2.3.3 消息映射

 

       树形控件的消息映射使用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 ；

2.3.4 动态提供结点所显示的字符

      首先你在添加结点时需要指明lpszItem参数为：LPSTR_TEXTCALLBACK；在控件显示该结点时会通过发送TVN_GETDISPINFO来取得所需要的字符；在处理该消息时先将参数pNMHDR转换为LPNMTVDISPINFO，然后填充其中item.pszText。但是通过什么来知道该结点所对应的信息呢，做法之一是在添加结点后设置其lParam参数，然后在提供信息时利用该参数来查找所对应的信息。下面的代码说明了这种方法：

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;
}

 

2.3.5 编辑结点的显示字符

     首先需要设置树形控件的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)
{
TV_DISPINFO* pTVDI = (TV_DISPINFO*)pNMHDR;
if(pTVDI->item.pszText==NULL);//判断是否已经取消取消编辑
    m_tree.SetItemText(pTVDI->item.hItem,pTVDI->pszText);
//重置显示字符
*pResult = 0;
}

     注：上面讲述的方法所进行的消息映射必须在父窗口中进行（同样WM_NOTIFY的所有消息都需要在父窗口中处理）。

 

3 关联控件：CImageList 

      如果需要在每个结点前添加一个小图标，可以关联CImageList控件。具体过程如下：

      首先，调用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的设置。

//添加，选中时显示图标1，未选中时显示图标0
/*m_list 为CImageList对象
IDB_TREE 为16*(16*4)的位图，每个图片为16*16共4个图标*/
m_list.Create(IDB_TREE,16,4,RGB(0,0,0));
m_tree.SetImageList(&m_list,TVSIL_NORMAL);
m_tree.InsertItem("Parent1",0,1);