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

 

插入Item还可以用结构体：

typedef struct tagTVINSERTSTRUCT {

    HTREEITEM hParent;                                  //父项

    HTREEITEM hInsertAfter;                           //后项

#if (_WIN32_IE >= 0x0400)

    union

    {

        TVITEMEX itemex;

        TVITEM item;

    } DUMMYUNIONNAME;

#else

    TVITEM item;

#endif

} TVINSERTSTRUCT, *LPTVINSERTSTRUCT;

 

typedef struct tagTVITEM {

    UINT mask;                                  //掩码

    HTREEITEM hItem;                         //该结构所引用的句柄

    UINT state;                                  //状态

    UINT stateMask;                           //状态字段的掩码

    LPTSTR pszText;                           //树项文本的缓冲区

    int cchTextMax;                            //树项文本的长度

    int iImage;                                   //树项落选时所所用的图像索引

    int iSelectedImage;                       //树项被选时所所用的图像索引

    int cChildren;                               //标识该项是否拥有相关联的子项

    LPARAM lParam;                            //32为的附加数据

} TVITEM, *LPTVITEM

 

mask字段值制定了 该结构的有效字段

TVIF_CHILDREN                      cChildren字段有效

TVIF_DI_SETITEM                  

TVIF_HANDLE                          hItem 字段有效

TVIF_IMAGE                             iImagez 字段有效

TVIF_PARAM                            lParam 字段有效

TVIF_SELECTEDIMAGE          iSelectedImage 字段有效

TVIF_STATE                              state和stateMask 字段有效

TVIF_TEXT                                pszText和cchTextMax 字段有效

 

 

 

如果你希望在每个结点前添加一个小图标，就必需先调用：

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
还有一些请查阅CSDN

 

NMTREEVIEW的结构体如下：

typedef struct tagNMTREEVIEW {

    NMHDR hdr;                                          //标准的NMHDR结构

    UINT action;                                           //通知的特定标志

    TVITEM itemOld;                                   //包含旧项状态信息的结构

    TVITEM itemNew;                                 //保存新项状况信息的结构

    POINT ptDrag;                                       //事件发生时鼠标的客户位置

} NMTREEVIEW, *LPNMTREEVIEW;

 

 

NMHDR我们都应该很熟悉了：

typedef struct tagNMHDR {

    HWND hwndFrom;

    UINT idFrom;

    UINT code;

} NMHDR;

 

下面是响应TVN_SELCHANGED通知消息的例子：

ON_NOTIRY(TVN_SELCHANGED,TREEID,OnSelectChanged);

void CTreePage::OnSelChanged(NMHDR* pNMHDR,LRESULT* pResult)

{

     NMTREEVIEW * pNMTreeView=( NMTREEVIEW * )pNMHDR;

     if(pNMTreeView->itemNew.state&TVIS_SELECTED)

          AfxMessageBox(m_tree.GetItemText(pNMTreeView->itemNew.hItem));

     *pResult=0;

}

我们也可以用消息反射，在此不在介绍了。