树形控件（CTreeCtrl）简介(转)

树形控件可以用于树形的结构，其中有一个根接点(Root)然后下面有许多子结点，而每个子结点上有允许有一个或多个或没有子结点。MFC中使用CTreeCtrl类来封装树形控件的各种操作。通过调用
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显示结点的显示字符
在树形控件中每一个结点都有一个句柄（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

/*假设m_tree为一个CTreeCtrl对象，而且该窗口已经创建*/
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);   

如果你希望在每个结点前添加一个小图标，就必需先调用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的设置。
/*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);//添加，选中时显示图标1，未选中时显示图标0

此外CTreeCtrl还提供了一些函数用于得到/修改控件的状态。
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( );将删除所有结点。

此外如果想遍历树可以使用下面的函数：
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有很多内容，将在以后的内容中进行详细讲解。

关于动态提供结点所显示的字符：首先你在添加结点时需要指明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;
}

关于编辑结点的显示字符：首先需要设置树形控件的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的所有消息都需要在父窗口中处理）。

树状控件的应用

何志丹

下面是树状控件的一些应用,由于是由于用于演示,所以结构并不合理.其效果如图所示..

步骤如下:

1,Insert -> new class,插入一个新类CMyCtrl,基类为CTreeCtrl.

2,利用类向导为CMyTree添加WM_PANIT的响应函数.

代码如下:

void CMyTree::OnPaint()

{

CPaintDC dc(this);

CWnd::DefWindowProc( WM_PAINT, (WPARAM)dc.GetSafeHdc(), 0 );

HTREEITEM hItem = this->GetFirstVisibleItem();

while(NULL != hItem)

{

UINT selflag = TVIS_DROPHILITED | TVIS_SELECTED;

if(GetItemState( hItem, selflag ) & selflag)

{

hItem = GetNextVisibleItem(hItem);

continue ;

}

CRect r;

GetItemRect(hItem,&r,true);

{//擦除旧内容

COLORREF col = dc.GetBkColor();

CBrush brush(col);

CPen pen(PS_NULL,1,col);

CBrush * pOldBrush = dc.SelectObject(&brush);

CPen * pOldPen = dc.SelectObject(&pen);

dc.Rectangle(&r);

dc.SelectObject(pOldBrush);

dc.SelectObject(pOldPen);

}

CString strText = GetItemText(hItem);

//设置颜色

dc.SetBkColor( GetSysColor( COLOR_WINDOW ) );

dc.SetTextColor(RGB(255,0,0));

//更改字体

LOGFONT logfont ;

GetFont()->GetLogFont( &logfont );

logfont.lfItalic = true;

CFont font;

font.CreateFontIndirect(&logfont);

dc.SelectObject(&font);

dc.TextOut(r.left + 2,r.top + 1,strText);

hItem = GetNextVisibleItem(hItem);

}

}

3,建立一个基于对话框的程序,增加一个树状控件,ctrl + w打开类向导,为它增加一个关联变量m_tree_ctrl.

4,对树状控件右键,选取属性,把has buttons,has lines,lines at root都选上.

5,手动把CTreeCtrl m_tree_ctrl;改成CMyTree m_tree_ctrl;不要忘记了包含头文件,

#include "MyTree.h"

6,修改对话框的OnInitDialog

BOOL CTestTreeDlg::OnInitDialog()

{

…..

HTREEITEM hRootItem = m_tree_ctrl.InsertItem("五虎上将!");

m_tree_ctrl.InsertItem("关羽",hRootItem);

m_tree_ctrl.InsertItem("张飞",hRootItem);

m_tree_ctrl.InsertItem("赵云",hRootItem);

m_tree_ctrl.InsertItem("马超",hRootItem);

m_tree_ctrl.InsertItem("黄忠",hRootItem);

}

7,Ctrl + F5.效果如图.

8,在资源管理器中增加一个位图,ID为IDB_STATE.

9, 在CMyTree中增加成员变量CImageList m_Images;

10,修改CMyTree的PreSubclassWindow的响应函数.

void CMyTree::PreSubclassWindow()

{

SetBkColor(RGB(255,255,255));

m_Images.Create (IDB_STATE, 18, 4, RGB (128, 0, 0));

SetImageList (&m_Images, TVSIL_NORMAL);

SetWindowLong(m_hWnd, GWL_STYLE, TVS_SHOWSELALWAYS|GetWindowLong(m_hWnd, GWL_STYLE));

CTreeCtrl::PreSubclassWindow();

}

11,增CMyTree类=NM_CLICK的响应函数.

void CMyTree::OnClick(NMHDR* pNMHDR, LRESULT* pResult)

{

DWORD dw = GetMessagePos();

CPoint pt(LOWORD(dw),HIWORD(dw));//鼠标的屏幕坐标

//转换为相对树控件的坐标

CPoint pt1 = pt;

CRect rect;

GetClientRect(rect);

ClientToScreen(&rect);

pt1.x -= rect.left;

pt1.y -= rect.top;

//判断在树控件中的位置

TVHITTESTINFO tHitTestInfo;

tHitTestInfo.pt = pt1;

HitTest(&tHitTestInfo);

if (TVHT_ONITEMICON == tHitTestInfo.flags)

{

int nImage,nSelectImage ;

GetItemImage(tHitTestInfo.hItem,nImage,nSelectImage);

if(0 == nImage)

SetItemImage(tHitTestInfo.hItem,3,3);

else if(3 == nImage)

SetItemImage(tHitTestInfo.hItem,0,0);

}

*pResult = 0;

}

12,把对话框标题改为”请选择出阵的武将”.

13, BOOL CTestTreeDlg::OnInitDialog()

{

…..

HTREEITEM hItem ;

hItem = m_tree_ctrl.InsertItem("关羽");

m_tree_ctrl.SetItemImage(hItem,1,1);

m_tree_ctrl.InsertItem("张飞");

m_tree_ctrl.InsertItem("赵云");

m_tree_ctrl.InsertItem("马超");

hItem = m_tree_ctrl.InsertItem("黄忠");

m_tree_ctrl.SetItemImage(hItem,2,2);

}

14,把树状控件的has line取消掉.

15,再为对话框换一个好看的图标.

16,结果如最前面.