CTreeCtrl 控件使用总结

一 基础操作 

1 插入节点

1）插入根节点

 

//插入根节点
HTREEITEM hRoot;
CString str=L"ROOT"
hRoot=nTreeCtrl.InsertItem(str);

//相当于
hRoot=nTreeCtrl.InsertItem(str,TVI_ROOT,TVI_LAST);

2）插入孩子节点

 

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

//相当于
HTREEITEM hChild=nTreeCtrl.InsertItem(str,hRoot,TVI_LAST);

 

2 获得节点句柄

//获得根节点
HTREEITEM hRootItem;
hRootItem=nTreeCtrl.GetRootItem();


//获得当前节点
HTREEITEM hCurrentItem;
hCurrentItem=nTreeCtrl.GetSelectedItem();


//获得hItem的前一个节点

HTREEITEM hPreItem;
hPreItem=nTreeCtrl.GetNextItem(hItem,TVGN_PREVIOUS);


//获得hItem的下一个节点
HTREEITEM hNextItem;
hNextItem=nTreeCtrl.GetNextItem(hItem,TVGN_NEXT);

 

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

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

 

4 展开或收缩子节点

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

 

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

//推断某节点是否有孩子节点
if (nTreeCtrl.ItemHasChildren(hRoot))
{
    //获得孩子节点
    HTREEITEM hChild=nTreeCtrl.GetChildItem(hRoot);

}

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

 

//推断某节点是否有孩子节点
if (nTreeCtrl.ItemHasChildren(hRoot))
{
    //获得孩子节点
    HTREEITEM hChild=nTreeCtrl.GetChildItem(hRoot);

    //遍历hRoot下一层的全部孩子节点
    while(hChild)
    {
        hChild=nTreeCtrl.GetNextItem(hChild,TVGN_NEXT);

    }

}

 

7  获得某节点上的文字

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

 

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

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

   其次： 选择该节点

treeCtrl.SelectItem(hItem);

  最后，设置焦点

treeCtrl.SetFocus();

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

9  清空树控件

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

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

 

void InsertPath(CString path, HTREEITEM hRoot, CTreeCtrl& ctrl)
{
    CFileFind nFindFile;
    CString str=L"";
    CString nPicFileName=L"";
    BOOL IsExist=FALSE;
    HTREEITEM hSubItem;

    nPicFileName.Format(L"%s\*.*",path);
    IsExist = nFindFile.FindFile(nPicFileName);
    while (IsExist)
    {
        IsExist = nFindFile.FindNextFile();
        if(nFindFile.IsDots())
            continue;
        nPicFileName = nFindFile.GetFileName();

        //路径
        if(nFindFile.IsDirectory())
        {
            hSubItem = ctrl.InsertItem(nPicFileName,hRoot);
            InsertPath(nFindFile.GetFilePath(),hSubItem,ctrl);
        }
        else
        {
            //文件
            str = nPicFileName.Right(4);
            if(!str.CompareNoCase(_T(".jpg")) || !str.CompareNoCase(_T(".tif")))
            {
                ctrl.InsertItem(nPicFileName,hRoot);
            }
        }
    }
    nFindFile.Close();
}

 

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

}

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

void InsetAllFile( list<CString>& filePathList){


    CTreeCtrl & nTreeCtrl=((CMyTreeView*)(((CMainFrame*)AfxGetMainWnd())->m_SplitterWnd.GetPane(0,0)))->GetTreeCtrl();
    nTreeCtrl.DeleteAllItems();

    list<CString>::iterator it=filePathList.begin();
    HTREEITEM hRoot=NULL;
    CString filePath;
    CString treeRootName=L"根文件夹";  //全部的文件都在根文件夹下  即：默认全部的文件都在同一个文件夹下

    while(it!=filePathList.end())
    {
        filePath=*it;



        if(hRoot==NULL)
            hRoot=nTreeCtrl.InsertItem(treeRootName);  //建立根文件夹



        if(filePath.Find(treeRootName)==0) // 文件第一层文件夹与根文件夹同样，则截去文件第一层文件夹。文件从第二层文件夹開始
            filePath=filePath.Right(filePath.GetLength()-treeRootName.GetLength()-1);


        LoadPicFiles(nTreeCtrl,filePath, hRoot);

        it++;
    }

}

void LoadPicFiles(CTreeCtrl& nTreeCtrl, CString nFilePath, HTREEITEM nRoot)
{

// 推断nPicFolder是文件夹还是文件
// 假设是文件
//     直接将文件插入到树控件中 nTreeCtrl.InsertItem(nPicFolder,nRoot);
// 假设是文件夹
//     获取nPicFolder的第一层文件夹
//     推断nRoot文件夹下是否已经有此层文件夹
//     假设有此层文件夹
//         递归插入其它
//     假设无此层文件夹
//         插入此层文件夹，然后递归插入其它


    CString nSubFolder;     //首层文件夹
    CString nSubFilePath;   //去掉首层文件夹后的文件名称
    BOOL IsExist=FALSE;



    int nIndex=-1;
    nIndex=nFilePath.Find(L'\');

    if(nIndex>=0) //文件夹
    {
        nSubFolder=nFilePath.Left(nIndex);
        nSubFilePath=nFilePath.Right(nFilePath.GetLength()-nIndex-1);

        HTREEITEM nSubRoot=NULL;
        if(nTreeCtrl.ItemHasChildren(nRoot))
            nSubRoot=nTreeCtrl.GetChildItem(nRoot);
        CString str;
        BOOL  bExist=FALSE;
        while(nSubRoot)
        {
            str=nTreeCtrl.GetItemText(nSubRoot);

            if (str.CompareNoCase(nSubFolder)==0)
            {

                bExist=TRUE;
                break;
            }

            nSubRoot=nTreeCtrl.GetNextSiblingItem(nSubRoot);
        }

        if(!bExist)
        {

            nSubRoot=nTreeCtrl.InsertItem(nSubFolder,nRoot);

            LoadPicFiles(nTreeCtrl,nSubFilePath,nSubRoot);
        }else{
            LoadPicFiles(nTreeCtrl,nSubFilePath,nSubRoot);
        }
    }
    else if(nFilePath.Find(L".jpg")!=-1 || nFilePath.Find(L".tif")!=-1)
    {
        nTreeCtrl.InsertItem(nFilePath,nRoot);
    }
}

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

二 扩展操作

 

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.

。。。

。

。。

。。。

typedef struct _NM_TREEVIEW {
  NMHDR hdr;
  UINT action;
  TV_ITEM itemOld;
  TV_ITEM itemNew;
  POINT ptDrag;
} NM_TREEVIEW;
typedef NM_TREEVIEW FAR* LPNM_TREEVIEW;

 

typedef struct _TV_ITEM { tvi
  UINT mask;
  HTREEITEM hItem;
  UINT state;
  UINT stateMask;
  LPSTR pszText;
  int cchTextMax;
  int iImage;
  int iSelectedImage;
  int cChildren;
  LPARAM lParam; }
TV_ITEM, FAR* LPTV_ITEM;

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

 

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

 

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

。。。
}

 

 

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

 解决：

方法1

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

 

方法2

响应TVN_ITEMEXPANDING事件时：

void CExampleDlg::OnItemexpandingTree1(NMHDR* pNMHDR, LRESULT* pResult)

{

NM_TREEVIEW* pNMTreeView = (NM_TREEVIEW*)pNMHDR;

if (pNMTreeView->action == TVE_COLLAPSE)   //推断action的值

。。。

。。。

}

 

 

 3  推断节点是否被扩展过

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

 

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

 

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

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

 

 5  什么时候响应OnItemexpanding 消息

 

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

 

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

 

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

 

设置控件样式：

BOOL CTreePathView::PreCreateWindow(CREATESTRUCT& cs)
{
    // TODO: 在此处通过改动
    //  CREATESTRUCT cs 来改动窗体类或样式

    cs.style|=TVS_HASLINES|TVS_SHOWSELALWAYS;   //若是想用CImageList的图标 ，则不要设置为TVS_HASBUTTONS形式


    return CTreeView::PreCreateWindow(cs);
}

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

void NewImageView::OnBnClickedButton5() // 上一个图
{
    // TODO: 在此加入控件通知处理程序代码

    CTreePathView * pTree=(CTreePathView* )(((CMainFrame *)AfxGetMainWnd())->m_wndSplitter.GetPane(0,0));

    CTreeCtrl & treeCtrl=pTree->GetTreeCtrl();

    HTREEITEM hItem=treeCtrl.GetSelectedItem();
    if (hItem!=NULL)
    {
        hItem=treeCtrl.GetNextItem(hItem,TVGN_PREVIOUS);

        if (hItem!=NULL)
        {
            CString str;
            str=pTree->GetFullPath(hItem);
            SetImage(str);
            treeCtrl.SelectItem(hItem);
            treeCtrl.SetFocus();
            InvalidateRect(m_ClientRect);
        }
    }
}

 

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

 

void NewImageView::OnBnClickedButton6() //下一个
{
    // TODO: 在此加入控件通知处理程序代码

    CTreePathView * pTree=(CTreePathView* )(((CMainFrame *)AfxGetMainWnd())->m_wndSplitter.GetPane(0,0));
    CTreeCtrl & treeCtrl=pTree->GetTreeCtrl();
    HTREEITEM hItem=treeCtrl.GetSelectedItem();

    if (hItem!=NULL)
    {
        hItem=treeCtrl.GetNextItem(hItem,TVGN_NEXT);

        if (hItem!=NULL)
        {
            CString str;
            str=pTree->GetFullPath(hItem);
            SetImage(str);

            treeCtrl.SelectItem(hItem);
            treeCtrl.SetFocus();
            InvalidateRect(m_ClientRect);
        }
    }
}

 

7  遍历树控件的全部节点

 

1） 获得根节点句柄

CTreeCtrl& nTreeCtrl=((CImportTreeView*)m_SplitterWnd.GetPane(0,0))->GetTreeCtrl();

HTREEITEM hItem;
//获得根文件夹节点
hItem = nTreeCtrl.GetRootItem();
//遍历树控件节点
TreeVisit(&nTreeCtrl,hItem);

 

2）遍历全部节点

void TreeVisit(CTreeCtrl* pCtrl,HTREEITEM hItem)
{
    if(pCtrl->ItemHasChildren(hItem))
    {
        HTREEITEM   hChildItem = pCtrl->GetChildItem(hItem);
        while(hChildItem!=NULL)
        {
            TreeVisit(pCtrl,hChildItem); //递归遍历孩子节点
            hChildItem  = pCtrl->GetNextItem(hChildItem, TVGN_NEXT);
        }
    }
    else // 对叶子节点进行操作
        Leaf(pCtrl,hItem);
}

8 获得某Item节点的全路径

   

CString m_ParentFolder[10];
CString m_OldParentFolder[10];

 

//--------------------将nParent加入到nParentFolder[10]第一位----------------------
BOOL AddParentFolder(CString nParentFolder[10], CString nParent)
{
    for(int i=9;i>0;i--)
        nParentFolder[i]=nParentFolder[i-1];
    nParentFolder[0]=nParent;
    return TRUE;
}

//---------------------nParentFolder[10]中的有效数据整合(加)---------------------
CString AllCString(CString nParentFolder[10])
{
    CString nAllCString=L"";
    for(int i=0;i<10;i++)
    {
        if(nParentFolder[i]==L"") break;
        nAllCString+=L"\"+nParentFolder[i];
    }
    return nAllCString;
}

获得Item节点路径的函数

CString GetItemPath(CTreeCtrl* pCtrl,HTREEITEM hItem)
{
    CString nSelItemName=pCtrl->GetItemText(hItem);

    HTREEITEM parentItem=pCtrl->GetParentItem(hItem);

    if (parentItem==NULL) //hItem即为根文件夹
        return nSelItemName;

    //清空OLD
    for(int i=0;i<10;i++) m_OldParentFolder[i]=L"";

    //m_OldParentFolder 记录上一个节点的父节点
    for(int i=0;i<10;i++)
        m_OldParentFolder[i]=m_ParentFolder[i];

    //m_ParentFolder 记录当前节点的父亲节点
    for(int i=0;i<10;i++)
        m_ParentFolder[i]=L"";

    CString itemPath;
    CString parentFolder=nSelItemName;

    //将parentFolder加入到m_ParentFolder[0],其它值依次后移
    AddParentFolder(m_ParentFolder,parentFolder);



    // m_PicFolder 为根节点相应的名字
    while(parentItem!=NULL&&pCtrl->GetItemText(parentItem).Compare(m_PicFolder))
    {
        parentFolder=pCtrl->GetItemText(parentItem);
        AddParentFolder(m_ParentFolder,parentFolder);
        parentItem=pCtrl->GetParentItem(parentItem);

    }

     itemPath.Format(L"%s%s",m_PicFolder,AllCString(m_ParentFolder));

     //清空OLD
     for(int i=0;i<10;i++) m_OldParentFolder[i]=L"";
     //清空
     for(int i=0;i<10;i++)
         m_ParentFolder[i]=L"";

     return itemPath;

}

 获得叶子节点的函数

void Leaf(CTreeCtrl* pCtrl,HTREEITEM hItem)
{

    CString itemName=pCtrl->GetItemText(hItem);

    // 叶子节点是jpg文件或tif文件
    if(nSelItemName.Find(L".jpg")!=-1 || nSelItemName.Find(L".tif")!=-1)
    {

        //m_OldParentFolder 记录上一个节点的父节点
        for(int i=0;i<10;i++)
            m_OldParentFolder[i]=m_ParentFolder[i];

        //m_ParentFolder 记录当前节点的父亲节点
        for(int i=0;i<10;i++)
            m_ParentFolder[i]=L"";

        CString imgPath=L"";
        CString parentFolder=itemName;

        //将parentFolder加入到m_ParentFolder[0],其它值依次后移
        AddParentFolder(m_ParentFolder,parentFolder);

        HTREEITEM parentItem=pCtrl->GetParentItem(hItem);

        // m_imgPath 为根节点相应的名字
        while(pCtrl->GetItemText(parentItem).Compare(m_imgPath))
        {
            parentFolder=pCtrl->GetItemText(parentItem);
            AddParentFolder(m_ParentFolder,parentFolder);
            parentItem=pCtrl->GetParentItem(parentItem)

        }

        // 获得叶子节点的全路径
        imgPath.Format(L"%s%s",m_imgPath,AllCString(m_ParentFolder));

    }


    // 对imgPath 所指的文件进行操作
    ShowPic(imgPath);


}

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

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

1）叶子节点

//本地是否存在此文章
void CMainFrame::PostPath(CTreeCtrl& nTreeCtrl, HTREEITEM hItem,CString &path)
{
    stack<HTREEITEM> itemStack;
    while (hItem!=nTreeCtrl.GetRootItem ())
    {
        itemStack.push(hItem);
        hItem=nTreeCtrl.GetParentItem (hItem);
    }
    itemStack.push(nTreeCtrl.GetRootItem ());
    CString itemName;
    while (!itemStack.empty())
    {
        hItem=(HTREEITEM)itemStack.top();
        itemStack.pop();
        itemName=nTreeCtrl.GetItemText (hItem);
        path+=itemName;
        path+=L"\";
    }
    path.TrimRight(L"\");
    path+=L".xml";
}

2）文件夹节点

void CMainFrame::DirPath(CTreeCtrl& nTreeCtrl, HTREEITEM nRoot,CString &path)
{
    stack<HTREEITEM> itemStack;
    while (hItem!=nTreeCtrl.GetRootItem ())
    {
        itemStack.push(hItem);
        hItem=nTreeCtrl.GetParentItem (hItem);
    }
    itemStack.push(nTreeCtrl.GetRootItem ());
    CString itemName;
    while (!itemStack.empty())
    {
        hItem=(HTREEITEM)itemStack.top();
        itemStack.pop();
        itemName=nTreeCtrl.GetItemText (hItem);
        path+=itemName;
        path+=L"\";
    }
}

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

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

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

void GetBookDirectory(CTreeCtrl* pCtrl,HTREEITEM hItem)
{

    if(pCtrl->ItemHasChildren(hItem))
    {
        HTREEITEM   hChildItem = pCtrl->GetChildItem(hItem);
        while(hChildItem!=NULL)
        {
            GetBookDirectory(pCtrl,hChildItem); //递归遍历孩子节点

            if(pCtrl->ItemHasChildren(hChildItem))
                hChildItem  = pCtrl->GetNextItem(hChildItem, TVGN_NEXT);
            else
                break;
        }
    }
    else
    {
        HTREEITEM parentItem=pCtrl->GetParentItem(hItem);
        CString bookPath=GetItemPath(pCtrl,parentItem);

        m_BookDirectory.push_back(bookPath);

    }
}

CTreeCtrl& nTreeCtrl=((CImportTreeView*)m_SplitterWnd.GetPane(0,0))->GetTreeCtrl();
HTREEITEM hItem;
hItem = nTreeCtrl.GetRootItem();

m_BookDirectory.clear();
GetBookDirectory(&nTreeCtrl,hItem);  //获得几本书 及书的路径

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

HTREEITEM InsertItem(
   LPCTSTR lpszItem,
   int nImage,        //实測范围0-65535
   int nSelectedImage,
   HTREEITEM hParent = TVI_ROOT,
   HTREEITEM hInsertAfter = TVI_LAST
);

存放65535以上的大数据时 用SetItemData 
A 32-bit application-specific value 

BOOL SetItemData(
   HTREEITEM hItem,
   DWORD_PTR dwData
);