鸡啄米vc++2010系列29（树形控件Tree Control 上）

时间：2021-12-26 19:59:38

树形控件简介

       树形控件在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++代码
  1. typedef struct tagTVITEM {   
  2.     UINT mask;       // 包含一些掩码位（下面的括号中列出）的组合，用来表明结构的哪些成员是有效的   
  3.     HTREEITEM hItem; // 树节点的句柄(TVIF_HANDLE)   
  4.     UINT state;      // 树节点的状态(TVIF_STATE)   
  5.     UINT stateMask;  // 状态的掩码组合(TVIF_STATE)   
  6.     LPTSTR pszText;  // 树节点的标签文本(TVIF_TEXT)   
  7.     int cchTextMax;  // 标签文本缓冲区的大小(TVIF_TEXT)   
  8.     int iImage;      // 树节点的图像索引(TVIF_IMAGE)   
  9.     int iSelectedImage;  // 选中项的图像索引(TVIF_SELECTEDIMAGE)   
  10.     int cChildren;   // 表明节点是否有子节点，为1则有，为0则没有(TVIF_CHILDREN)   
  11.     LPARAM lParam;   // 一个32 位的附加数据(TVIF_PARAM)   
  12. } 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++代码
  1. typedef struct tagNMTREEVIEW {   
  2.     NMHDR hdr;      // 标准的NMHDR结构   
  3.     UINT action;    // 表明是用户的什么行为触发了该通知消息   
  4.     TVITEM itemOld; // 原节点的属性   
  5.     TVITEM itemNew; // 新节点的属性   
  6.     POINT ptDrag;   // 事件发生时鼠标的客户区坐标   
  7. } NMTREEVIEW, *LPNMTREEVIEW;  

       4. TVINSERTSTRUCT结构体

       向树形控件中插入新节点时需要用到TVINSERTSTRUCT结构体，它常与TVM_INSERTITEM消息一起使用。定义如下：

C++代码
  1. typedef struct tagTVINSERTSTRUCT {   
  2.     HTREEITEM hParent;      // 父节点的句柄   
  3.     HTREEITEM hInsertAfter; // 指明插入到同层中哪一项的后面   
  4. #if (_WIN32_IE >= 0x0400)   
  5.     union  
  6.     {   
  7.         TVITEMEX itemex;   
  8.         TVITEM item;   
  9.     } DUMMYUNIONNAME;   
  10. #else   
  11.     TVITEM item;            // 要添加的新节点的属性   
  12. #endif   
  13. } TVINSERTSTRUCT, *LPTVINSERTSTRUCT;  

       若hParent成员为TVI_ROOT或NULL，那么新节点将被作为树的根节点插入。hInsertAfter除了可以是某个节点的句柄，还可以有四种取值：TVI_FIRST（插入到树形控件的最前面）、TVI_LAST（插入到树形控件的最后面）、TVI_ROOT（作为根节点插入）和TVI_SORT（按字母顺序插入）。

       5. NMTVDISPINFO结构体

       NMTVDISPINFO结构体中包含了与树节点的显示有关的信息。定义如下：

C++代码
  1. typedef struct tagNMTVDISPINFO {   
  2.     NMHDR hdr;   
  3.     TVITEM item;   
  4. } NMTVDISPINFO, *LPNMTVDISPINFO;  

       关于树形控件的使用本节先讲这么多，在下节将继续讲解CTreeCtrl类的相关知识和实例。鸡啄米谢谢大家能一直跟随着我学习VS2010/MFC，继续加油！


标签：

相关文章