?

樹形控件Tree Control

?

前面兩節為大家講了列表視圖控件List Control，這一節開始介紹一種特殊的列表--樹形控件Tree Control。

???????樹形控件簡介

???????樹形控件在Windows系統中是很常見的，例如資源管理器左側的窗口中就有用來顯示目錄的樹形視圖。樹形視圖中以分層結構顯示數據，每層的縮進不同，層次越低縮進越多。樹形控件的節點一般都由標簽和圖標兩部分組成，圖標用來抽象的描述數據，能夠使樹形控件的層次關系更加清晰。

?????? 樹形控件在插入新的樹節點時會稍麻煩些，回顧之前的列表框，插入新列表項時調用AddString成員函數就可以了，而對于樹形控件則需要指定新節點與已有節點的關系。另外，樹形控件與列表視圖控件一樣，可以在每一個節點的左邊加入圖標。這些都使得樹形控件給人一種復雜的感覺，但我們在使用它一兩次后會發現其實樹形控件用起來還是很方便的。

???????樹形控件的通知消息

?????? 下面列出樹形控件特有的通知消息中比較常用的幾個：

?????? TVN_SELCHANGING和TVN_SELCHANGED：在用戶改變了對樹節點的選擇時，控件會發送這兩個消息。消息會附帶一個指向NMTREEVIEW結構的指針，程序可從該結構中獲得必要的信息。兩個消息都會在該結構的itemOld成員中包含原來的選擇項信息，在itemNew成員中包含新選擇項的信息，在action成員中表明是用戶的什么行為觸發了該通知消息(若是TVC_BYKEYBOARD則表明是鍵盤，若是TVC_BYMOUSE則表明是鼠標，若是TVC_UNKNOWN則表示未知）。兩個消息的不同之處在于，如果TVN_SELCHANGING的消息處理函數返回TRUE，那么就阻止選擇的改變，如果返回FALSE，則允許改變。

???????TVN_KEYDOWN：該消息表明了一個鍵盤事件。消息會附帶一個指向NMTVKEYDOWN結構的指針，通過該結構程序可以獲得按鍵的信息。

?????? TVN_BEGINLABELEDIT和TVN_ENDLABELEDIT：分別在用戶開始編輯和結束編輯節點的標簽時發送。消息會附帶一個指向NMTVDISPINFO結構的指針，程序可從該結構中獲得必要的信息。在前者的消息處理函數中，可以調用GetEditControl()成員函數返回一個指向用于編輯標題的編輯框的指針。如果處理函數返回FALSE，則允許編輯，如果返回TRUE，則禁止編輯。在后者的消息處理函數中，NMTVDISPINFO結構中的item.pszText指向編輯后的新標題，如果pszText為NULL，那么說明用戶放棄了編輯，否則，程序應負責更新節點的標簽，這可以由SetItem()或SetItemText()函數來完成。

???????樹形控件的相關數據結構

???????1. HTREEITEM句柄

?????? 樹形控件中的每個節點都可以由一個HTREEITEM類型的句柄表示。我們通過CTreeCtrl類的成員函數對樹進行訪問和操作時，很多時候都要用到HTREEITEM句柄。

???????2. TVITEM結構體

?????? TVITEM結構體描述了樹形控件節點的屬性，定義如下：

C++代碼 typedef struct tagTVITEM { UINT mask; // 包含一些掩碼位（下面的括號中列出）的組合，用來表明結構的哪些成員是有效的 HTREEITEM hItem; // 樹節點的句柄(TVIF_HANDLE) UINT state; // 樹節點的狀態(TVIF_STATE) UINT stateMask; // 狀態的掩碼組合(TVIF_STATE) LPTSTR pszText; // 樹節點的標簽文本(TVIF_TEXT) int cchTextMax; // 標簽文本緩沖區的大小(TVIF_TEXT) int iImage; // 樹節點的圖像索引(TVIF_IMAGE) int iSelectedImage; // 選中項的圖像索引(TVIF_SELECTEDIMAGE) int cChildren; // 表明節點是否有子節點，為1則有，為0則沒有(TVIF_CHILDREN) LPARAM lParam; // 一個32 位的附加數據(TVIF_PARAM) } TVITEM, *LPTVITEM;

?

?????? 此結構體中多個元素涉及到了圖像和狀態等，有必要具體解釋下。

?????? 樹形控件節點需要顯示圖標時，就要為樹形控件關聯一個圖像序列，上面的iImage成員就代表了該結構體對應的樹節點的圖標在圖像序列中的索引，iSelectedImage則代表該樹節點被選中時顯示的圖標在圖像序列中的索引。對于如何為樹形控件關聯圖像序列，雞啄米將在后面的實例中講到。

?????? stateMask用來說明要獲取或設置樹節點的哪些狀態。下面是state和stateMask的一些常用值及含義：

????????? state??????????????????????????? 對應的stateMask?????????????????????? 含義?????????
?????? TVIS_CUT????????????????????????? TVIS_CUT??????????????????????? 節點被選擇用來進行剪切和粘貼操作
?????? TVIS_DROPHILITED?????????? TVIS_DROPHILITED???????? 節點成為拖動操作的目標
?????? TVIS_EXPANDED???????????????TVIS_EXPANDED????????????? 節點的子節點被展開
?????? TVIS_EXPANDEDONCE????? TVIS_EXPANDEDONCE???? 節點的子節點曾經被展開過
?????? TVIS_SELECTED?????????????? ?TVIS_SELECTED?????????????? 節點被選中

?????? lParam在實際開發中常用來存放與樹節點有關的附加數據。

???????3. NMTREEVIEW結構體

?????? NMTREEVIEW結構體中包含了樹形控件通知消息的相關信息。樹形控件的大多數通知消息都會帶有指向該結構體的指針。NMTREEVIEW結構體的定義如下：

C++代碼 typedef struct tagNMTREEVIEW { NMHDR hdr; // 標準的NMHDR結構 UINT action; // 表明是用戶的什么行為觸發了該通知消息 TVITEM itemOld; // 原節點的屬性 TVITEM itemNew; // 新節點的屬性 POINT ptDrag; // 事件發生時鼠標的客戶區坐標 } NMTREEVIEW, *LPNMTREEVIEW;

?

???????4. TVINSERTSTRUCT結構體

?????? 向樹形控件中插入新節點時需要用到TVINSERTSTRUCT結構體，它常與TVM_INSERTITEM消息一起使用。定義如下：

C++代碼 typedef struct tagTVINSERTSTRUCT { HTREEITEM hParent; // 父節點的句柄 HTREEITEM hInsertAfter; // 指明插入到同層中哪一項的后面 #if (_WIN32_IE >= 0x0400) union { TVITEMEX itemex; TVITEM item; } DUMMYUNIONNAME; #else TVITEM item; // 要添加的新節點的屬性 #endif } TVINSERTSTRUCT, *LPTVINSERTSTRUCT;

?

?? ??? 若hParent成員為TVI_ROOT或NULL，那么新節點將被作為樹的根節點插入。hInsertAfter除了可以是某個節點的句柄，還可以有四種取值：TVI_FIRST（插入到樹形控件的最前面）、TVI_LAST（插入到樹形控件的最后面）、TVI_ROOT（作為根節點插入）和TVI_SORT（按字母順序插入）。

???????5. NMTVDISPINFO結構體

?????? NMTVDISPINFO結構體中包含了與樹節點的顯示有關的信息。定義如下：

C++代碼

typedef struct tagNMTVDISPINFO { NMHDR hdr; TVITEM item; } NMTVDISPINFO, *LPNMTVDISPINFO;

?

?? ??? 關于樹形控件的使用本節先講這么多，在下節將繼續講解CTreeCtrl類的相關知識和實例。雞啄米謝謝大家能一直跟隨著我學習VS2010/MFC，繼續加油！

?

前面一節講了樹形控件Tree Control的簡介、通知消息以及相關數據結構，本節繼續講下半部分，包括樹形控件的創建、CTreeCtrl類的主要成員函數和應用實例。

???????樹形控件的創建

???????MFC為樹形控件提供了CTreeCtrl類，它封裝了樹形控件的所有操作。

?????? 樹形控件的創建也是有兩種方式，一種是在對話框模板中直接拖入Tree Control控件創建，另一種就是通過CTreeCtrl類的Create成員函數創建。下面主要講后者。

?????? CTreeCtrl類的Create成員函數的原型如下：

virtual BOOL Create(DWORD dwStyle,const RECT& rect,CWnd* pParentWnd,UINT nID );

?

?

?????? 此函數的原型與前面講到的所有控件類的Create函數都類似。dwStyle指定樹形控件風格的組合，rect指定樹形控件窗口的位置和大小，pParentWnd為指向樹形控件父窗口的指針，nID指定樹形控件的ID。下面還是主要講講樹形控件的主要風格以及含義。

?????? TVS_DISABLEDRAGDROP：禁止樹形控件發送TVN_BEGINDRAG通知消息，即不支持拖動操作
?????? TVS_EDITLABELS：用戶可以編輯節點的標簽文本
?????? TVS_HASBUTTONS：顯示帶有＂+＂或＂-＂的小方框來表示某項能否被展開或已展開
?????? TVS_HASLINES：在父節點與子節點間連線以更清晰地顯示樹的結構
?????? TVS_LINESATROOT：在根節點處連線
?????? TVS_SHOWSELALWAYS：即使控件失去輸入焦點，仍顯示出項的選擇狀態

?????? 同樣，動態創建樹形控件時，除了能夠指定上述風格的組合外，一般還要指定WS_CHILD和WS_VISIBLE風格。

?????? 在對話框模板中直接拖入Tree Control創建樹形控件時，可以在樹形控件的屬性頁中設置其風格，與上面的風格是對應的，例如，屬性Has Lines對應的就是TVS_HASLINES風格。

???????CTreeCtrl類的主要成員函數

???????CImageList* SetImageList(CImageList * pImageList,int nImageListType);

?????? 如果樹節點需要顯示圖標時，則必須先創建一個CImageList類的對象，并為其添加多個圖像組成一個圖像序列，然后調用SetImageList函數為樹形控件設置圖像序列，在用InsertItem插入節點時傳入所需圖像在圖像序列中的索引即可。后面的例子中會演示。參數pImageList為指向圖像序列類CImageList的對象的指針，若為NULL則刪除樹形控件的所有圖像。參數nImageListType指定圖像序列的類型，可以是TVSIL_NORMAL（普通圖像序列）或TVSIL_STATE（狀態圖像序列，用圖像表示節點的狀態）。

???????UINT GetCount( ) const;

?????? 獲取樹形控件中節點的數量。

???????DWORD_PTR GetItemData(HTREEITEM hItem) const;

?????? 獲取樹形控件中某個指定節點的附加32位數據。參數hItem為指定的樹節點的句柄。

???????BOOL SetItemData(HTREEITEM hItem,DWORD_PTR dwData);

?????? 為樹形控件中某個指定節點設置附加的32位數據。參數hItem同上，dwData為要設置的32位數據。

???????CString GetItemText(HTREEITEM hItem) const;

?????? 獲取樹形控件中某個指定節點的標簽文本。參數hItem同上。返回值是包含標簽文本的字符串。

???????BOOL SetItemText(HTREEITEM hItem,LPCTSTR lpszItem);

?????? 為樹形控件中某個指定節點設置標簽文本。參數hItem同上，lpszItem為包含標簽文本的字符串的指針。

???????HTREEITEM GetNextSiblingItem(HTREEITEM hItem) const;

?????? 獲取樹形控件中某個指定節點的下一個兄弟節點。參數hItem同上。返回值是下一個兄弟節點的句柄。

???????HTREEITEM GetPrevSiblingItem(HTREEITEM hItem) const;

?????? 獲取樹形控件中某個指定節點的上一個兄弟節點。參數hItem同上。返回值是上一個兄弟節點的句柄。

???????HTREEITEM GetParentItem(HTREEITEM hItem) const;

?????? 獲取樹形控件中某個指定節點的父節點。參數hItem同上。返回值是父節點的句柄。

???????HTREEITEM GetRootItem( ) const;

?????? 獲取樹形控件根節點的句柄。

???????HTREEITEM GetSelectedItem( ) const;

?????? 獲取樹形控件當前選中節點的句柄。

???????BOOL DeleteAllItems( );

?????? 刪除樹形控件中的所有節點。刪除成功則返回TRUE，否則返回FALSE。

???????BOOL DeleteItem(HTREEITEM hItem);

?????? 刪除樹形控件中的某個節點。參數hItem為要刪除的節點的句柄。刪除成功則返回TRUE，否則返回FALSE。

???????HTREEITEM InsertItem(LPCTSTR lpszItem,int nImage,int nSelectedImage,HTREEITEM hParent = TVI_ROOT,HTREEITEM hInsertAfter = TVI_LAST);

?????? 在樹形控件中插入一個新節點。參數lpszItem為新節點的標簽文本字符串的指針，參數nImage為新節點的圖標在樹形控件圖像序列中的索引，參數nSelectedImage為新節點被選中時的圖標在圖像序列中的索引，參數hParent為插入節點的父節點的句柄，參數hInsertAfter為新節點的前一個節點的句柄，即新節點將被插入到hInsertAfter節點之后。

???????BOOL SelectItem(HTREEITEM hItem);

?????? 選中指定的樹節點。參數hItem為要選擇的節點的句柄。若成功則返回TRUE，否則返回FALSE。

???????樹形控件的應用實例

???????最后雞啄米還是給大家寫一個簡單的實例，說明CListCtrl類的幾個成員函數及樹形控件通知消息等的使用方法。

?????? 此實例實現的功能：在一個樹形控件中顯示雞啄米網站的簡單結構分層，共有三層，分別為雞啄米網站、各個分類和文章。用鼠標左鍵單擊改變選中節點后，將選中節點的文本顯示到編輯框中。另外，還要實現一個常見的效果，就是鼠標劃過除根節點外的某個樹節點時，顯示相應的Tip提示信息。下面是具體實現步驟：

?????? 1. 創建一個基于對話框的MFC工程，名稱設置為“Example31”。

?????? 2. 在自動生成的對話框模板IDD_EXAMPLE31_DIALOG中，刪除“TODO: Place dialog controls here.”靜態文本框、“OK”按鈕和“Cancel”按鈕。添加一個Tree Control控件，ID設置為IDC_WEB_TREE，屬性Has Buttons、Has Lines和Lines At Root都設為True，為了在鼠標劃過某個節點時顯示提示信息還需要將Info Tip屬性設為True。再添加一個靜態文本框和一個編輯框，靜態文本框的Caption屬性設為“您選擇的節點：”，編輯框的ID設為IDC_ITEM_SEL_EDIT，Read Only屬性設為True。此時的對話框模板如下圖： ??

? ? ? ??

?????? 3. 導入需要為樹形控件的節點添加的圖標。雞啄米在這里找了三個32x32的Icon圖標，保存到工程的res目錄下。然后在Resource View資源視圖中，右鍵點擊Icon節點，在右鍵菜單中選擇“Add Resource...”，彈出“Add Resource”對話框，再從左邊“Resource type”列表中選擇“Icon”，點擊右邊的“Import...”按鈕，就可以選擇三個圖標文件進行導入了。導入成功后，分別修改它們ID為IDI_WEB_ICON、IDI_CATALOG_ICON和IDI_ARTICLE_ICON。

?????? 4. 為樹形控件IDC_WEB_TREE添加CTreeCtrl類型的控件變量m_webTree。并在Example31Dlg.h文件中為CExample31Dlg類添加成員對象：CImageList m_imageList;。

?????? 5. 在對話框初始化時，我們在樹形控件中添加雞啄米網站的樹形結構，那么需要修改CExample31Dlg::OnInitDialog()函數為：

C++代碼

BOOL CExample31Dlg::OnInitDialog() { CDialogEx::OnInitDialog(); // ......略 // TODO: Add extra initialization here HICON hIcon[3]; // 圖標句柄數組 HTREEITEM hRoot; // 樹的根節點的句柄 HTREEITEM hCataItem; // 可表示任一分類節點的句柄 HTREEITEM hArtItem; // 可表示任一文章節點的句柄 // 加載三個圖標，并將它們的句柄保存到數組 hIcon[0] = theApp.LoadIcon(IDI_WEB_ICON); hIcon[1] = theApp.LoadIcon(IDI_CATALOG_ICON); hIcon[2] = theApp.LoadIcon(IDI_ARTICLE_ICON); // 創建圖像序列CImageList對象 m_imageList.Create(32, 32, ILC_COLOR32, 3, 3); // 將三個圖標添加到圖像序列 for (int i=0; i<3; i++) { m_imageList.Add(hIcon[i]); } // 為樹形控件設置圖像序列 m_webTree.SetImageList(&m_imageList, TVSIL_NORMAL); // 插入根節點 hRoot = m_webTree.InsertItem(_T("雞啄米"), 0, 0); // 在根節點下插入子節點 hCataItem = m_webTree.InsertItem(_T("IT互聯網"), 1, 1, hRoot, TVI_LAST); // 為“IT互聯網”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hCataItem, 1); // 在“IT互聯網”節點下插入子節點 hArtItem = m_webTree.InsertItem(_T("百度文章1"), 2, 2, hCataItem, TVI_LAST); // 為“百度文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 2); // 在“IT互聯網”節點下插入另一子節點 hArtItem = m_webTree.InsertItem(_T("谷歌文章2"), 2, 2, hCataItem, TVI_LAST); // 為“谷歌文章2”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 3); // 在根節點下插入第二個子節點 hCataItem = m_webTree.InsertItem(_T("數碼生活"), 1, 1, hRoot, TVI_LAST); // 為“數碼生活”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hCataItem, 4); // 在“數碼生活”節點下插入子節點 hArtItem = m_webTree.InsertItem(_T("智能手機文章1"), 2, 2, hCataItem, TVI_LAST); // 為“智能手機文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 5); // 在“數碼生活”節點下插入另一子節點 hArtItem = m_webTree.InsertItem(_T("平板電腦文章2"), 2, 2, hCataItem, TVI_LAST); // 為“平板電腦文章2”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 6); // 在根節點下插入第三個子節點 hCataItem = m_webTree.InsertItem(_T("軟件開發"), 1, 1, hRoot, TVI_LAST); // 為“軟件開發”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hCataItem, 7); // 在“軟件開發”節點下插入子節點 hArtItem = m_webTree.InsertItem(_T("C++編程入門系列1"), 2, 2, hCataItem, TVI_LAST); // 為“C++編程入門系列1”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 8); // 在“軟件開發”節點下插入另一子節點 hArtItem = m_webTree.InsertItem(_T("VS2010/MFC編程入門2"), 2, 2, hCataItem, TVI_LAST); // 為“VS2010/MFC編程入門2”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 9); // 在根節點下插入第四個子節點 hCataItem = m_webTree.InsertItem(_T("娛樂休閑"), 1, 1, hRoot, TVI_LAST); // 為“娛樂休閑”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hCataItem, 10); // 在“娛樂休閑”節點下插入子節點 hArtItem = m_webTree.InsertItem(_T("瑪雅文明文章1"), 2, 2, hCataItem, TVI_LAST); // 為“瑪雅文明文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 11); // 在“娛樂休閑”節點下插入另一子節點 hArtItem = m_webTree.InsertItem(_T("IT笑話2"), 2, 2, hCataItem, TVI_LAST); // 為“IT笑話2”節點添加附加的編號數據，在鼠標劃過該節點時顯示 m_webTree.SetItemData(hArtItem, 12); return TRUE; // return TRUE unless you set the focus to a control }

?

?????? 6. 我們希望在選中節點改變時，將最新的選擇項實時顯示到編輯框中，那么可以響應TVN_SELCHANGED通知消息。為樹形控件IDC_WEB_TREE的通知消息TVN_SELCHANGED添加消息處理函數CExample31Dlg::OnTvnSelchangedWebTree，并修改函數體如下：

C++代碼

void CExample31Dlg::OnTvnSelchangedWebTree(NMHDR *pNMHDR, LRESULT *pResult) { LPNMTREEVIEW pNMTreeView = reinterpret_cast<LPNMTREEVIEW>(pNMHDR); // TODO: Add your control notification handler code here *pResult = 0; CString strText; // 樹節點的標簽文本字符串 // 獲取當前選中節點的句柄 HTREEITEM hItem = m_webTree.GetSelectedItem(); // 獲取選中節點的標簽文本字符串 strText = m_webTree.GetItemText(hItem); // 將字符串顯示到編輯框中 SetDlgItemText(IDC_ITEM_SEL_EDIT, strText); }

?

??

?????? 7. 還有一個功能需要實現，那就是鼠標劃過除根節點外的某個樹節點時，顯示相應的Tip提示信息，本實例中提示信息為節點的編號。這需要響應TVN_GETINFOTIP通知消息。為樹形控件IDC_WEB_TREE的通知消息TVN_GETINFOTIP添加消息處理函數CExample31Dlg::OnTvnGetInfoTipWebTree，并修改函數體如下：

C++代碼

void CExample31Dlg::OnTvnGetInfoTipWebTree(NMHDR *pNMHDR, LRESULT *pResult) { LPNMTVGETINFOTIP pGetInfoTip = reinterpret_cast<LPNMTVGETINFOTIP>(pNMHDR); // TODO: Add your control notification handler code here *pResult = 0; NMTVGETINFOTIP* pTVTipInfo = (NMTVGETINFOTIP*)pNMHDR; // 將傳入的pNMHDR轉換為NMTVGETINFOTIP指針類型 HTREEITEM hRoot = m_webTree.GetRootItem(); // 獲取樹的根節點 CString strText; // 每個樹節點的提示信息 if (pTVTipInfo->hItem == hRoot) { // 如果鼠標劃過的節點是根節點，則提示信息為空 strText = _T(""); } else { // 如果鼠標劃過的節點不是根節點，則將該節點的附加32位數據格式化為字符串 strText.Format(_T("%d"), pTVTipInfo->lParam); } // 將strText字符串拷貝到pTVTipInfo結構體變量的pszText成員中，這樣就能顯示內容為strText的提示信息 wcscpy(pTVTipInfo->pszText, strText); }

?

?????? 8. 運行程序，彈出結果對話框。效果如下圖：

??　　

???????樹形控件的知識就講到這里了，相比之前的控件可能稍有復雜。不過用的多了，就會覺得得心應手了。雞啄米歡迎大家繼續關注后面的VS2010/MFC編程入門教程。

轉載于:https://www.cnblogs.com/Dageking/archive/2013/03/14/2959070.html

總結

以上是生活随笔為你收集整理的树形控件Tree Control的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。