VS2010/MFC編程之樹型控件的創建及CTreeCtrl類的成員函數和實例

原創 一抹爱念 2018-08-22 09:46

樹形控件的創建

       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++代碼
  1. BOOL CExample31Dlg::OnInitDialog()   
  2. {   
  3.     CDialogEx::OnInitDialog();   
  4.          ......略   
  5.   
  6.     // TODO: Add extra initialization here   
  7.     HICON hIcon[3];      // 圖標句柄數組   
  8.     HTREEITEM hRoot;     // 樹的根節點的句柄   
  9.     HTREEITEM hCataItem; // 可表示任一分類節點的句柄   
  10.     HTREEITEM hArtItem;  // 可表示任一文章節點的句柄   
  11.   
  12.     // 加載三個圖標，並將它們的句柄保存到數組   
  13.     hIcon[0] = theApp.LoadIcon(IDI_WEB_ICON);   
  14.     hIcon[1] = theApp.LoadIcon(IDI_CATALOG_ICON);   
  15.     hIcon[2] = theApp.LoadIcon(IDI_ARTICLE_ICON);   
  16.   
  17.     // 創建圖像序列CImageList對象   
  18.     m_imageList.Create(32, 32, ILC_COLOR32, 3, 3);   
  19.     // 將三個圖標添加到圖像序列   
  20.     for (int i=0; i<3; i++)   
  21.     {   
  22.         m_imageList.Add(hIcon[i]);   
  23.     }   
  24.   
  25.     // 爲樹形控件設置圖像序列   
  26.     m_webTree.SetImageList(&m_imageList, TVSIL_NORMAL);   
  27.   
  28.     // 插入根節點   
  29.     hRoot = m_webTree.InsertItem(_T("雞啄米"), 0, 0);   
  30.     // 在根節點下插入子節點   
  31.     hCataItem = m_webTree.InsertItem(_T("IT互聯網"), 1, 1, hRoot, TVI_LAST);   
  32.     // 爲“IT互聯網”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  33.     m_webTree.SetItemData(hCataItem, 1);   
  34.     // 在“IT互聯網”節點下插入子節點   
  35.     hArtItem = m_webTree.InsertItem(_T("百度文章1"), 2, 2, hCataItem, TVI_LAST);   
  36.     // 爲“百度文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  37.     m_webTree.SetItemData(hArtItem, 2);   
  38.     // 在“IT互聯網”節點下插入另一子節點   
  39.     hArtItem = m_webTree.InsertItem(_T("谷歌文章2"), 2, 2, hCataItem, TVI_LAST);   
  40.     // 爲“谷歌文章2”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  41.     m_webTree.SetItemData(hArtItem, 3);   
  42.     // 在根節點下插入第二個子節點   
  43.     hCataItem = m_webTree.InsertItem(_T("數碼生活"), 1, 1, hRoot, TVI_LAST);   
  44.     // 爲“數碼生活”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  45.     m_webTree.SetItemData(hCataItem, 4);   
  46.     // 在“數碼生活”節點下插入子節點   
  47.     hArtItem = m_webTree.InsertItem(_T("智能手機文章1"), 2, 2, hCataItem, TVI_LAST);   
  48.     // 爲“智能手機文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  49.     m_webTree.SetItemData(hArtItem, 5);   
  50.     // 在“數碼生活”節點下插入另一子節點   
  51.     hArtItem = m_webTree.InsertItem(_T("平板電腦文章2"), 2, 2, hCataItem, TVI_LAST);   
  52.     // 爲“平板電腦文章2”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  53.     m_webTree.SetItemData(hArtItem, 6);   
  54.     // 在根節點下插入第三個子節點   
  55.     hCataItem = m_webTree.InsertItem(_T("軟件開發"), 1, 1, hRoot, TVI_LAST);   
  56.     // 爲“軟件開發”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  57.     m_webTree.SetItemData(hCataItem, 7);   
  58.     // 在“軟件開發”節點下插入子節點   
  59.     hArtItem = m_webTree.InsertItem(_T("C++編程入門系列1"), 2, 2, hCataItem, TVI_LAST);   
  60.     // 爲“C++編程入門系列1”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  61.     m_webTree.SetItemData(hArtItem, 8);   
  62.     // 在“軟件開發”節點下插入另一子節點   
  63.     hArtItem = m_webTree.InsertItem(_T("VS2010/MFC編程入門2"), 2, 2, hCataItem, TVI_LAST);   
  64.     // 爲“VS2010/MFC編程入門2”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  65.     m_webTree.SetItemData(hArtItem, 9);   
  66.     // 在根節點下插入第四個子節點   
  67.     hCataItem = m_webTree.InsertItem(_T("娛樂休閒"), 1, 1, hRoot, TVI_LAST);   
  68.     // 爲“娛樂休閒”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  69.     m_webTree.SetItemData(hCataItem, 10);   
  70.     // 在“娛樂休閒”節點下插入子節點   
  71.     hArtItem = m_webTree.InsertItem(_T("瑪雅文明文章1"), 2, 2, hCataItem, TVI_LAST);   
  72.     // 爲“瑪雅文明文章1”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  73.     m_webTree.SetItemData(hArtItem, 11);   
  74.     // 在“娛樂休閒”節點下插入另一子節點   
  75.     hArtItem = m_webTree.InsertItem(_T("IT笑話2"), 2, 2, hCataItem, TVI_LAST);   
  76.     // 爲“IT笑話2”節點添加附加的編號數據，在鼠標劃過該節點時顯示   
  77.     m_webTree.SetItemData(hArtItem, 12);   
  78.   
  79.     return TRUE;  // return TRUE  unless you set the focus to a control   
  80. }  

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

C++代碼
  1. void CExample31Dlg::OnTvnSelchangedWebTree(NMHDR *pNMHDR, LRESULT *pResult)   
  2. {   
  3.     LPNMTREEVIEW pNMTreeView = reinterpret_cast<LPNMTREEVIEW>(pNMHDR);   
  4.     // TODO: Add your control notification handler code here   
  5.     *pResult = 0;   
  6.   
  7.     CString strText; // 樹節點的標籤文本字符串   
  8.        
  9.     // 獲取當前選中節點的句柄   
  10.     HTREEITEM hItem = m_webTree.GetSelectedItem();   
  11.     // 獲取選中節點的標籤文本字符串   
  12.     strText = m_webTree.GetItemText(hItem);   
  13.     // 將字符串顯示到編輯框中   
  14.     SetDlgItemText(IDC_ITEM_SEL_EDIT, strText);   
  15. }  

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

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

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

樹形控件效果圖


——————文章來源於雞啄米《VS2010/MFC編程入門》

發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章

GridFS簡介

吳起輝 2019-02-24 14:19:04

java命名規範

黑暗中行走 2019-02-23 14:01:27

窗體編程之窗體的事件

ers456 2019-02-23 13:43:17

菜鳥創建優秀網頁的6個好習慣.

verytt 2019-02-23 13:40:45

FIRST_MFC

youyou輝 2019-02-23 13:38:56

ajax 使用心得

中原是戲臺 2019-02-23 13:27:58

Java技術學習：如何保證同一資源被多個線程併發訪問時的完整性？

QFdongdong 2019-02-23 13:24:15

Java行業新手如何適應工作？

QFdongdong 2019-02-23 13:24:15

Windows server 2003 *** 配置實例

czq2008sky 2019-02-23 13:38:34

Windows server 2003 *** 配置實例（Site to Site)

czq2008sky 2019-02-23 13:38:34

MySQL 事務、函數、觸發器、數據庫備份、權限管理

死瘦宅 2019-02-24 22:35:12

Xcode與C++之遊戲開發：Pong遊戲

優惠碼優惠 2019-02-24 19:41:23

Android開發學習之使用Toolbar實現不同的Fragment使用不同顏色的標題欄與狀態欄

優惠券發放 2019-02-24 19:41:23

PHP hebrev()函數用法講解

php参考手册 2019-02-24 12:43:05

opencv函數速查筆記

羽化飛仙 2019-02-23 13:31:17