CTreeCtrl 控件使用总结

一 基础操作 

1 插入节点

1）插入根节点

[cpp] view
plaincopy

1. //插入根节点
2. HTREEITEM hRoot;
3. CString str=L"ROOT"
4. hRoot=nTreeCtrl.InsertItem(str);
5. //相当于
6. hRoot=nTreeCtrl.InsertItem(str,TVI_ROOT,TVI_LAST);

2）插入孩子节点

[cpp] view
plaincopy

1. //加入hRoot节点的孩子节点，而且被加入的节点位于hRoot全部孩子节点的末尾
2. HTREEITEM hChild=nTreeCtrl.InsertItem(str,hRoot);
3. //相当于
4. HTREEITEM hChild=nTreeCtrl.InsertItem(str,hRoot,TVI_LAST);

2 获得节点句柄

[cpp] view
plaincopy

1. //获得根节点
2. HTREEITEM hRootItem;
3. hRootItem=nTreeCtrl.GetRootItem();
4. //获得当前节点
5. HTREEITEM hCurrentItem;
6. hCurrentItem=nTreeCtrl.GetSelectedItem();
7. //获得hItem的前一个节点
8. HTREEITEM hPreItem;
9. hPreItem=nTreeCtrl.GetNextItem(hItem,TVGN_PREVIOUS);
10. //获得hItem的下一个节点
11. HTREEITEM hNextItem;
12. hNextItem=nTreeCtrl.GetNextItem(hItem,TVGN_NEXT);

3 推断某节点是否有孩子节点

[cpp] view
plaincopy

1. //推断某节点是否有孩子节点
2. if (nTreeCtrl.ItemHasChildren(hRoot))

4 展开或收缩子节点

[cpp] view
plaincopy

1. //展开
2. if(nTreeCtrl.ItemHasChildren(hRoot))
3. nTreeCtrl.Expand(hParentItem,TVE_EXPAND);

5 获得第一个孩子节点的句柄

[cpp] view
plaincopy

1. //推断某节点是否有孩子节点
2. if (nTreeCtrl.ItemHasChildren(hRoot))
3. {
4. //获得孩子节点
5. HTREEITEM hChild=nTreeCtrl.GetChildItem(hRoot);
6. }

6 遍历hRoot下一层的全部孩子节点

[cpp] view
plaincopy

1. //推断某节点是否有孩子节点
2. if (nTreeCtrl.ItemHasChildren(hRoot))
3. {
4. //获得孩子节点
5. HTREEITEM hChild=nTreeCtrl.GetChildItem(hRoot);
6. //遍历hRoot下一层的全部孩子节点
7. while(hChild)
8. {
9. hChild=nTreeCtrl.GetNextItem(hChild,TVGN_NEXT);
10. }
11. }

7  获得某节点上的文字

[cpp] view
plaincopy

1. //获得某节点上的文字
2. CString str;
3. nTreeCtrl.GetItemText(hRoot);

8 选择某节点。并让其获得焦点

首先，TREE控件的样式必须设置为TVS_SHOWSELALWAYS

其次： 选择该节点

[html] view
plaincopy

1. treeCtrl.SelectItem(hItem);

最后，设置焦点

[html] view
plaincopy

1. treeCtrl.SetFocus();

Tree控件设置焦点后，会自己主动将焦点定位到选择的节点上

9  清空树控件

[cpp] view
plaincopy

1. <strong>  nTreeCtrl.DeleteAllItems();</strong>

 10  将指定文件夹下的文件插入节点

[cpp] view
plaincopy

1. void InsertPath(CString path, HTREEITEM hRoot, CTreeCtrl& ctrl)
2. {
3. CFileFind nFindFile;
4. CString str=L"";
5. CString nPicFileName=L"";
6. BOOL IsExist=FALSE;
7. HTREEITEM hSubItem;
8. nPicFileName.Format(L"%s\\*.*",path);
9. IsExist = nFindFile.FindFile(nPicFileName);
10. while (IsExist)
11. {
12. IsExist = nFindFile.FindNextFile();
13. if(nFindFile.IsDots())
14. continue;
15. nPicFileName = nFindFile.GetFileName();
16. //路径
17. if(nFindFile.IsDirectory())
18. {
19. hSubItem = ctrl.InsertItem(nPicFileName,hRoot);
20. InsertPath(nFindFile.GetFilePath(),hSubItem,ctrl);
21. }
22. else
23. {
24. //文件
25. str = nPicFileName.Right(4);
26. if(!str.CompareNoCase(_T(".jpg")) || !str.CompareNoCase(_T(".tif")))
27. {
28. ctrl.InsertItem(nPicFileName,hRoot);
29. }
30. }
31. }
32. nFindFile.Close();
33. }

[cpp] view
plaincopy

1. void LoadPath(CString path) //path为指定文件夹   此函数的作用为将path文件夹下的文件插入树控件中
2. {
3. CTreeCtrl& ctrl = GetTreeCtrl();
4. ASSERT(ctrl);
5. ctrl.DeleteAllItems();
6. HTREEITEM hRoot = ctrl.InsertItem(path);
7. InsertPath(path,hRoot,ctrl);
8. ctrl.Expand(hRoot,TVE_EXPAND);
9. }

11 将文件列表中的文件插入树控件中

[cpp] view
plaincopy

1. void InsetAllFile( list<CString>& filePathList){
2. CTreeCtrl & nTreeCtrl=((CMyTreeView*)(((CMainFrame*)AfxGetMainWnd())->m_SplitterWnd.GetPane(0,0)))->GetTreeCtrl();
3. nTreeCtrl.DeleteAllItems();
4. list<CString>::iterator it=filePathList.begin();
5. HTREEITEM hRoot=NULL;
6. CString filePath;
7. CString treeRootName=L"根文件夹";  //全部的文件都在根文件夹下  即：默认全部的文件都在同一个文件夹下
8. while(it!=filePathList.end())
9. {
10. filePath=*it;
11. if(hRoot==NULL)
12. hRoot=nTreeCtrl.InsertItem(treeRootName);  //建立根文件夹
13. if(filePath.Find(treeRootName)==0) // 文件第一层文件夹与根文件夹同样，则截去文件第一层文件夹。文件从第二层文件夹開始
14. filePath=filePath.Right(filePath.GetLength()-treeRootName.GetLength()-1);
15. LoadPicFiles(nTreeCtrl,filePath, hRoot);
16. it++;
17. }
18. }

[cpp] view
plaincopy

1. void LoadPicFiles(CTreeCtrl& nTreeCtrl, CString nFilePath, HTREEITEM nRoot)
2. {
3. // 推断nPicFolder是文件夹还是文件
4. // 假设是文件
5. //     直接将文件插入到树控件中 nTreeCtrl.InsertItem(nPicFolder,nRoot);
6. // 假设是文件夹
7. //     获取nPicFolder的第一层文件夹
8. //     推断nRoot文件夹下是否已经有此层文件夹
9. //     假设有此层文件夹
10. //         递归插入其它
11. //     假设无此层文件夹
12. //         插入此层文件夹，然后递归插入其它
13. CString nSubFolder;     //首层文件夹
14. CString nSubFilePath;   //去掉首层文件夹后的文件名称
15. BOOL IsExist=FALSE;
16. int nIndex=-1;
17. nIndex=nFilePath.Find(L'\\');
18. if(nIndex>=0) //文件夹
19. {
20. nSubFolder=nFilePath.Left(nIndex);
21. nSubFilePath=nFilePath.Right(nFilePath.GetLength()-nIndex-1);
22. HTREEITEM nSubRoot=NULL;
23. if(nTreeCtrl.ItemHasChildren(nRoot))
24. nSubRoot=nTreeCtrl.GetChildItem(nRoot);
25. CString str;
26. BOOL  bExist=FALSE;
27. while(nSubRoot)
28. {
29. str=nTreeCtrl.GetItemText(nSubRoot);
30. if (str.CompareNoCase(nSubFolder)==0)
31. {
32. bExist=TRUE;
33. break;
34. }
35. nSubRoot=nTreeCtrl.GetNextSiblingItem(nSubRoot);
36. }
37. if(!bExist)
38. {
39. nSubRoot=nTreeCtrl.InsertItem(nSubFolder,nRoot);
40. LoadPicFiles(nTreeCtrl,nSubFilePath,nSubRoot);
41. }else{
42. LoadPicFiles(nTreeCtrl,nSubFilePath,nSubRoot);
43. }
44. }
45. else if(nFilePath.Find(L".jpg")!=-1 || nFilePath.Find(L".tif")!=-1)
46. {
47. nTreeCtrl.InsertItem(nFilePath,nRoot);
48. }
49. }

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

二 扩展操作

1 响应TVN_ITEMEXPANDING  消息时   怎样获得将要展开或收缩的那一个节点的句柄

MSDN：

<strong>TVN_ITEMEXPANDING</strong> <em><a target=_blank target="_blank" class="synParam" href="http://blog.csdn.net/shuilan0066/article/details/6638504" style="color: rgb(255, 153, 0); text-decoration: none;">pnmtv</a></em> <strong>= (NM_TREEVIEW FAR *)</strong> <em>lParam</em>

pnmtv

Pointer to an NM_TREEVIEW structure.
The itemNew member is aTVITEM structure that contains valid information about the parent
item in thehItem,state, andlParam members. Theaction member indicates whether the list is to expand or collapse. For a list of possible values, see the description of theTVM_EXPAND message.

。。。

。

。。

。。。

[cpp] view
plaincopy

1. typedef struct _NM_TREEVIEW {
2. NMHDR hdr;
3. UINT action;
4. TV_ITEM itemOld;
5. TV_ITEM itemNew;
6. POINT ptDrag;
7. } NM_TREEVIEW;
8. typedef NM_TREEVIEW FAR* LPNM_TREEVIEW;

[cpp] view
plaincopy

1. typedef struct _TV_ITEM { tvi
2. UINT mask;
3. HTREEITEM hItem;
4. UINT state;
5. UINT stateMask;
6. LPSTR pszText;
7. int cchTextMax;
8. int iImage;
9. int iSelectedImage;
10. int cChildren;
11. LPARAM lParam; }
12. TV_ITEM, FAR* LPTV_ITEM;

在 TV_ITEM 的 hItem中 存放着要展开项的句柄

解决：查了这么多，事实上非常easy 代码例如以下：

[cpp] view
plaincopy

1. void CLeftView::OnItemexpanding(NMHDR* pNMHDR, LRESULT* pResult)
2. {
3. LPNMTREEVIEW pNMTreeView = reinterpret_cast<LPNMTREEVIEW>(pNMHDR);
4. // TODO: 在此加入控件通知处理程序代
5. HTREEITEM htree=pNMTreeView->itemNew.hItem; // 这个就是 将要被扩展或收缩节点的句柄
6. 。。。

7. }

2 怎么知道CTreeCtrl的一个节点是展开的还是收缩着的

 解决：

方法1

[cpp] view
plaincopy

1. <strong>     (GetItemState(hItem,   TVIS_EXPANDED   )&TVIS_EXPANDED)!=TVIS_EXPANDED  //假设相等，则说明改节点是扩展的，假设不相等，则说明该节点是收缩的</strong>

方法2

响应TVN_ITEMEXPANDING事件时：

[cpp] view
plaincopy

1. void CExampleDlg::OnItemexpandingTree1(NMHDR* pNMHDR, LRESULT* pResult)
2. {
3. NM_TREEVIEW* pNMTreeView = (NM_TREEVIEW*)pNMHDR;
4. if (pNMTreeView->action == TVE_COLLAPSE)   //推断action的值
5. 。。。

6. 。。。
7. }

 3  推断节点是否被扩展过

[cpp] view
plaincopy

1. if ((GetTreeCtrl().GetItemState(hItem,TVIS_EXPANDEDONCE )&TVIS_EXPANDEDONCE )!=0 ) //推断是否扩展过一次，若！=0则说明被扩展过

4   使用 CImageList m_ImageList; 载入位图或图标。并将其与树控件联系在一起。由此便能够设置每一个节点的图标

[cpp] view
plaincopy

1. CImageList m_ImageList;
2. m_ImageList.Create(12,12,ILC_COLORDDB | ILC_MASK, 3, 1);
3. HICON hAdd=::LoadIcon(::AfxGetInstanceHandle(), (LPCTSTR)IDI_ADD);
4. HICON hRemove=::LoadIcon(::AfxGetInstanceHandle(), (LPCTSTR)IDI_REMOVE);
5. HICON hLeaf=::LoadIcon(::AfxGetInstanceHandle(), (LPCTSTR)IDI_LEAF);
6. m_ImageList.Add(hAdd);
7. m_ImageList.Add(hRemove);
8. m_ImageList.Add(hLeaf);
9. GetTreeCtrl().SetImageList(&m_ImageList,TVSIL_NORMAL);  // 树控件和图像列表相连

[cpp] view
plaincopy

1. m_treeCtrl.SetItemImage(htree,0,0)   // 通过SetItemImage(htree,0,0) 设置节点的图标

 5  什么时候响应OnItemexpanding 消息

     当节点第一次被展开时，才响应此消息。也就是说：当以开后该节点再展开或收缩时，便不再响应此消息了。

6  设置树控件形式为 TVS_HASBUTTONS|TVS_LINESATROOT 时， 树控件节点前才会出现+ - 号

下面为综合样例： 点击button上一个 显示该节点的上一个兄弟节点。并更改控件焦点

设置控件样式：

[html] view
plaincopy

1. BOOL CTreePathView::PreCreateWindow(CREATESTRUCT& cs)
2. {
3. // TODO: 在此处通过改动
4. //  CREATESTRUCT cs 来改动窗体类或样式
5. cs.style|=TVS_HASLINES|TVS_SHOWSELALWAYS;   //若是想用CImageList的图标 ，则不要设置为TVS_HASBUTTONS形式
6. return CTreeView::PreCreateWindow(cs);
7. }

点击button5（焦点移动到上一个兄弟节点）

[html] view
plaincopy

1. void NewImageView::OnBnClickedButton5() // 上一个图
2. {
3. // TODO: 在此加入控件通知处理程序代码
4. CTreePathView * pTree=(CTreePathView* )(((CMainFrame *)AfxGetMainWnd())->m_wndSplitter.GetPane(0,0));
5. CTreeCtrl & treeCtrl=pTree->GetTreeCtrl();
6. HTREEITEM hItem=treeCtrl.GetSelectedItem();
7. if (hItem!=NULL)
8. {
9. hItem=treeCtrl.GetNextItem(hItem,TVGN_PREVIOUS);
10. if (hItem!=NULL)
11. {
12. CString str;
13. str=pTree->GetFullPath(hItem);
14. SetImage(str);
15. treeCtrl.SelectItem(hItem);
16. treeCtrl.SetFocus();
17. InvalidateRect(m_ClientRect);
18. }
19. }
20. }

点击button6（焦点移动到下一个兄弟节点）

[html] view
plaincopy

1. void NewImageView::OnBnClickedButton6() //下一个
2. {
3. // TODO: 在此加入控件通知处理程序代码
4. CTreePathView * pTree=(CTreePathView* )(((CMainFrame *)AfxGetMainWnd())->m_wndSplitter.GetPane(0,0));
5. CTreeCtrl & treeCtrl=pTree->GetTreeCtrl();
6. HTREEITEM hItem=treeCtrl.GetSelectedItem();
7. if (hItem!=NULL)
8. {
9. hItem=treeCtrl.GetNextItem(hItem,TVGN_NEXT);
10. if (hItem!=NULL)
11. {
12. CString str;
13. str=pTree->GetFullPath(hItem);
14. SetImage(str);
15. treeCtrl.SelectItem(hItem);
16. treeCtrl.SetFocus();
17. InvalidateRect(m_ClientRect);
18. }
19. }
20. }

7  遍历树控件的全部节点

1） 获得根节点句柄

[cpp] view
plaincopy

1. CTreeCtrl& nTreeCtrl=((CImportTreeView*)m_SplitterWnd.GetPane(0,0))->GetTreeCtrl();
2. HTREEITEM hItem;
3. //获得根文件夹节点
4. hItem = nTreeCtrl.GetRootItem();
5. //遍历树控件节点
6. TreeVisit(&nTreeCtrl,hItem);

2）遍历全部节点

[cpp] view
plaincopy

1. void TreeVisit(CTreeCtrl* pCtrl,HTREEITEM hItem)
2. {
3. if(pCtrl->ItemHasChildren(hItem))
4. {
5. HTREEITEM   hChildItem = pCtrl->GetChildItem(hItem);
6. while(hChildItem!=NULL)
7. {
8. TreeVisit(pCtrl,hChildItem); //递归遍历孩子节点
9. hChildItem  = pCtrl->GetNextItem(hChildItem, TVGN_NEXT);
10. }
11. }
12. else // 对叶子节点进行操作
13. Leaf(pCtrl,hItem);
14. }

8 获得某Item节点的全路径

[cpp] view
plaincopy

1. CString m_ParentFolder[10];
2. CString m_OldParentFolder[10];

[cpp] view
plaincopy

1. //--------------------将nParent加入到nParentFolder[10]第一位----------------------
2. BOOL AddParentFolder(CString nParentFolder[10], CString nParent)
3. {
4. for(int i=9;i>0;i--)
5. nParentFolder[i]=nParentFolder[i-1];
6. nParentFolder[0]=nParent;
7. return TRUE;
8. }
9. //---------------------nParentFolder[10]中的有效数据整合(加\)---------------------
10. CString AllCString(CString nParentFolder[10])
11. {
12. CString nAllCString=L"";
13. for(int i=0;i<10;i++)
14. {
15. if(nParentFolder[i]==L"") break;
16. nAllCString+=L"\\"+nParentFolder[i];
17. }
18. return nAllCString;
19. }

获得Item节点路径的函数

[cpp] view
plaincopy

1. CString GetItemPath(CTreeCtrl* pCtrl,HTREEITEM hItem)
2. {
3. CString nSelItemName=pCtrl->GetItemText(hItem);
4. HTREEITEM parentItem=pCtrl->GetParentItem(hItem);
5. if (parentItem==NULL) //hItem即为根文件夹
6. return nSelItemName;
7. //清空OLD
8. for(int i=0;i<10;i++) m_OldParentFolder[i]=L"";
9. //m_OldParentFolder 记录上一个节点的父节点
10. for(int i=0;i<10;i++)
11. m_OldParentFolder[i]=m_ParentFolder[i];
12. //m_ParentFolder 记录当前节点的父亲节点
13. for(int i=0;i<10;i++)
14. m_ParentFolder[i]=L"";
15. CString itemPath;
16. CString parentFolder=nSelItemName;
17. //将parentFolder加入到m_ParentFolder[0],其它值依次后移
18. AddParentFolder(m_ParentFolder,parentFolder);
19. // m_PicFolder 为根节点相应的名字
20. while(parentItem!=NULL&&pCtrl->GetItemText(parentItem).Compare(m_PicFolder))
21. {
22. parentFolder=pCtrl->GetItemText(parentItem);
23. AddParentFolder(m_ParentFolder,parentFolder);
24. parentItem=pCtrl->GetParentItem(parentItem);
25. }
26. itemPath.Format(L"%s%s",m_PicFolder,AllCString(m_ParentFolder));
27. //清空OLD
28. for(int i=0;i<10;i++) m_OldParentFolder[i]=L"";
29. //清空
30. for(int i=0;i<10;i++)
31. m_ParentFolder[i]=L"";
32. return itemPath;
33. }

 获得叶子节点的函数

[cpp] view
plaincopy

1. void Leaf(CTreeCtrl* pCtrl,HTREEITEM hItem)
2. {
3. CString itemName=pCtrl->GetItemText(hItem);
4. // 叶子节点是jpg文件或tif文件
5. if(nSelItemName.Find(L".jpg")!=-1 || nSelItemName.Find(L".tif")!=-1)
6. {
7. //m_OldParentFolder 记录上一个节点的父节点
8. for(int i=0;i<10;i++)
9. m_OldParentFolder[i]=m_ParentFolder[i];
10. //m_ParentFolder 记录当前节点的父亲节点
11. for(int i=0;i<10;i++)
12. m_ParentFolder[i]=L"";
13. CString imgPath=L"";
14. CString parentFolder=itemName;
15. //将parentFolder加入到m_ParentFolder[0],其它值依次后移
16. AddParentFolder(m_ParentFolder,parentFolder);
17. HTREEITEM parentItem=pCtrl->GetParentItem(hItem);
18. // m_imgPath 为根节点相应的名字
19. while(pCtrl->GetItemText(parentItem).Compare(m_imgPath))
20. {
21. parentFolder=pCtrl->GetItemText(parentItem);
22. AddParentFolder(m_ParentFolder,parentFolder);
23. parentItem=pCtrl->GetParentItem(parentItem)
24. }
25. // 获得叶子节点的全路径
26. imgPath.Format(L"%s%s",m_imgPath,AllCString(m_ParentFolder));
27. }
28. // 对imgPath 所指的文件进行操作
29. ShowPic(imgPath);
30. }

上述方法过于繁杂，再来了简洁些的

使用栈。依次将本节点-->根节点入栈     出栈时顺序便为根节点-->本节点

1）叶子节点

[cpp] view
plaincopy

1. //本地是否存在此文章
2. void CMainFrame::PostPath(CTreeCtrl& nTreeCtrl, HTREEITEM hItem,CString &path)
3. {
4. stack<HTREEITEM> itemStack;
5. while (hItem!=nTreeCtrl.GetRootItem ())
6. {
7. itemStack.push(hItem);
8. hItem=nTreeCtrl.GetParentItem (hItem);
9. }
10. itemStack.push(nTreeCtrl.GetRootItem ());
11. CString itemName;
12. while (!itemStack.empty())
13. {
14. hItem=(HTREEITEM)itemStack.top();
15. itemStack.pop();
16. itemName=nTreeCtrl.GetItemText (hItem);
17. path+=itemName;
18. path+=L"\\";
19. }
20. path.TrimRight(L"\\");
21. path+=L".xml";
22. }

2）文件夹节点

[cpp] view
plaincopy

1. void CMainFrame::DirPath(CTreeCtrl& nTreeCtrl, HTREEITEM nRoot,CString &path)
2. {
3. stack<HTREEITEM> itemStack;
4. while (hItem!=nTreeCtrl.GetRootItem ())
5. {
6. itemStack.push(hItem);
7. hItem=nTreeCtrl.GetParentItem (hItem);
8. }
9. itemStack.push(nTreeCtrl.GetRootItem ());
10. CString itemName;
11. while (!itemStack.empty())
12. {
13. hItem=(HTREEITEM)itemStack.top();
14. itemStack.pop();
15. itemName=nTreeCtrl.GetItemText (hItem);
16. path+=itemName;
17. path+=L"\\";
18. }
19. }

9  获得树中全部叶子节点的父文件夹

    即：树中可能有很多枝干，获取这些枝干的路径

[cpp] view
plaincopy

1. std::vector<CString> m_BookDirectory; //存放全部叶子节点的父文件夹

[cpp] view
plaincopy

1. void GetBookDirectory(CTreeCtrl* pCtrl,HTREEITEM hItem)
2. {
3. if(pCtrl->ItemHasChildren(hItem))
4. {
5. HTREEITEM   hChildItem = pCtrl->GetChildItem(hItem);
6. while(hChildItem!=NULL)
7. {
8. GetBookDirectory(pCtrl,hChildItem); //递归遍历孩子节点
9. if(pCtrl->ItemHasChildren(hChildItem))
10. hChildItem  = pCtrl->GetNextItem(hChildItem, TVGN_NEXT);
11. else
12. break;
13. }
14. }
15. else
16. {
17. HTREEITEM parentItem=pCtrl->GetParentItem(hItem);
18. CString bookPath=GetItemPath(pCtrl,parentItem);
19. m_BookDirectory.push_back(bookPath);
20. }
21. }

[cpp] view
plaincopy

1. CTreeCtrl& nTreeCtrl=((CImportTreeView*)m_SplitterWnd.GetPane(0,0))->GetTreeCtrl();
2. HTREEITEM hItem;
3. hItem = nTreeCtrl.GetRootItem();
4. m_BookDirectory.clear();
5. GetBookDirectory(&nTreeCtrl,hItem);  //获得几本书 及书的路径

10 利用InsertItem、SetItemData 存放与该节点有关的数字信息

[cpp] view
plaincopy

1. HTREEITEM InsertItem(
2. LPCTSTR lpszItem,
3. int nImage,        //实測范围0-65535
4. int nSelectedImage,
5. HTREEITEM hParent = TVI_ROOT,
6. HTREEITEM hInsertAfter = TVI_LAST
7. );

存放65535以上的大数据时 用SetItemData 

A 32-bit application-specific value

[cpp] view
plaincopy

1. BOOL SetItemData(
2. HTREEITEM hItem,
3. DWORD_PTR dwData
4. );