C++ Builder 初学问与答(六)

6.图形列表组件TreeView
　　45）问：有时侯，我希望实现类似资源管理器对文件夹管理的显示方式，和对文件的管理显示方式，在C++Builder中应该怎么办？

　答：在C++Builder中可以直接使用图形列表组件来实现，它包括TreeView、ListView以及Outline组件。其中Outline组件实际上是基于Windows 3.1环境的组件，而且无论从功能还是使用的角度来看，它都无法与TreeView相比，因此完全可以用TreeView组件代替Outline。所以我将主要介绍前面两种组件。这两个组件都在页Win32中。

　　46)问：TreeView组件是一个怎样的组件？

　　答：TreeView组件比较复杂，所以我们首先简单地介绍一下这个组件的基本使用情况，然后再深入讨论。

　　TreeView组件采用了树形结构，最典型的例子就是Windows 95的资源管理器，它用树形结构显示磁盘上的文件夹和文件。因此TreeView组件能够清晰地显示层次关系。

　　47）问：请给我演示一下怎样在设计状态编辑TreeView好吗？

　　答：首先在窗体上放置一个TreeView组件，然后在对象编辑器中单击属性Items中的省略号按钮，就会打开一个项目编辑器。

　　TreeView组件的项目编辑器是一个在设计时专门增加、删除节点和为节点赋予图标的工具。从屏幕上可以看到，项目编辑器由项目组框和项目属性组框组成。项目组框由一个项目列表框、按钮New Item、按钮New SubItem、按钮Delete和按钮Load组成。当你刚打开项目编辑器时，项目列表框是空的，New SubItem和Delete按钮处于失效状态。

　　项目属性组框由编辑框Text、编辑框Image Index、编辑框Selected Index和编辑框State Index组成。

　　项目组框可以创建和删除节点、子节点。如果要载入一个已经存在的TreeView节点，可以单击按钮Load。要创建一个新项目，单击New Item，然后在文本编辑框中输入新节点的标题。这时，New SubItem按钮由失效变为有效，允许你在节点下再嵌套子节点。如果项目列表框中显示了节点，那么Delete按钮也会变的有效。你只要在项目列表框中选中这个节点然后单击Delete按钮，就可以删除这个节点了。

　　要注意的是：如果删除的节点还包括子节点，那么子节点也会被同时删除。

　　项目属性组框主要是为当前选中的节点（或子节点）设置属性的。其中编辑框Text可以修改节点的标题。如果要在不是当前被选中的节点的左边显示图像，那么应该在编辑框Image Index中输入图像的索引号。要禁止显示图像可以把这个节点Image Index设置为缺省值-1。

　　如果要在被选中的节点的左边显示图像，应该在编辑框Selected Index中指定图像的索引号，索引号是从0开始的。要禁止显示图像可以把它设置为缺省值-1。

　如果要在节点的左边多显示一个图像，可以在编辑框State Index中输入图像的索引号。这个索引号代表Tree View组件中的StateImages属性所表示的图像列表的索引。要禁止显示图像可以把这个项目设置为缺省值-1。

　　注意：Image Index与 Selected Index 使用的是Images指定的ImageList；而State Index使用的是StateImages 指定的ImageList。

　　48）问：TreeView的属性太多了，我想问我一定要清楚哪些主要属性？

　　答： Items ： 该属性包含TreeView组件中的所有节点，它是TtreeNodes的对象，在设计时，你可以使用项目编辑器来增加、删除和修改节点。在运行期间，可以通过Items属性访问每一个节点，并且也能够增加、删除和修改节点。而每一个节点又都是一个TtreeNode对象。

　　AutoEWxpand：布尔类型。为true时，则当前被选择的节点将自动扩展，没有被选择节点将自动折叠。缺省为false，这时扩展和折叠要用户自己指定。

　　DragMode：其声明为：_property TdragMode DragMode；这个属性用来设置树状视图的拖放模式。缺省为dmManual，用户要拖放节点需要调用BeginDrag才能拖放。若设置为 dmAutomatic，则树状视图将支持自动拖放，用户可以把一个节点拖到另一个位置。

　　Images：用来设定TreeView中的不同节点的图标。

　　StateImages：用不同的的图像来表示节点的不同状态。

　　在TreeView组件中，每个节点除了可以有一个文字标题外，还可以附加图标，这样可以使用户界面更加直观。这两个属性就包含着节点所使用的图标。

　　这两个属性都是TImageList的对象，所以如果要在TreeView组件中给节点添加图标，就必须使用图标列表组件给这两个属性赋值。如果在窗体中放置了图标列表组件，那么单击属性Images中的下拉按钮，就可以选取这个组件了。

　　ShowButtons属性值为True时表示凡是有子节点的节点将自动具有扩展按钮（即+号按钮）和折叠按钮（即减号按钮），单击它们就可以扩展和折叠节点。属性值为False时，不显示这两个按钮，缺省值为True。

　　ShowLines属性用来确定是否显示在节点和子节点之间的连线。缺省值为True。

　　ShowRoot属性用来确定与顶层节点连线是否显示。缺省值为True。

　　HideSelection属性用来确定当输入焦点从TreeView移动到其它控件上时，被选中的节点是否处于被选中状态。当属性值为True时，不再处于选中状态。缺省值为True。

　　Indent属性用来设置子节点与父节点之间缩进显示的距离。

　　ReadOnly用来确定用户是否可以直接修改节点的标题。当属性值为False时，表示可以修改。修改方法是，选中要修改的节点并单击进入编辑状态。缺省值为False。

　　SortType用来设置节点进行排序的方式。它有以下几种取值：

　　stNone：不排序（缺省值）；

　　stData：当节点所关联的对象发生改变时重新排序；

　　stText：当节点的标签发生变化时重新排序；

　　stBoth：当节点所关联的对象或者节点的标签发生改变时重新排序。

　　以上排序原则为在同一层的节点以标签的字母顺序排序。

此外，还有一些运行时态属性。

　　TopItem：这个属性用来设置一个节点，这个节点将显示在树状视图的最上面。

　　RowSelcet：缺省为false。若设置为true，则表示当前选择的节点所在的整行都将加亮显示。当ShowLines设置为true时，这个属性无效。

　　Selected：用来返回当前选择的节点。

　　49）问：属性Images和StateImages有什么区别呢？

　　答：每一个节点可以有两个附带的图标。一般情况下只需要显示一个图标，这时我们经常使用Images来指定图标，也就是说给属性Images赋予一个ImageList对象。如果某个节点要显示两个图标，那么还需要给属性StateImages赋予一个ImageList对象。然后给节点的属性StateIndex指定图标的索引号。具体的方法是在项目编辑器中，修改编辑框State Index的值。

　　其实在显示一个图标时，也可以使用属性StateImages。但是使用Images属性有一个优点，就是它可以为处于不同状态的节点指定不同的图标。例如在Windows 95的资源管理器中，被选中的节点显示一个打开的文件夹，而没有选中的节点显示一个关闭的文件夹。要实现这一点很简单，因为项目编辑器中的编辑框Image Index指定的图标在节点未选中时显示，而编辑框Seleted Index指定的图像在节点选中时显示。

　　50）问：请在前面设计的TreeView组件的基础上，给TreeView组件中的节点增加图标。好吗？

　　答：好的，首先在窗体上放置两个ImageList组件，这两个组件将具有缺省的名字ImageList1和ImageList2。

　　其次、编辑ImageList组件：ImageList组件实际上是一个图标列表，它可以包含大量的图标，这些图标的大小由属性Width和Height确定，缺省值都是16。

　　ImageList刚建立时不包含任何图标，你需要把已创建好的图标引入到ImageList中。这个工作可以通过ImageList编辑器完成。

　　用鼠标右键单击ImageList组件，在快捷菜单中选择ImageList Editor或双击一下该组件，就会出现下面这个编辑器。

　　单击Add按钮，在弹出的Add Images对话框中选择要引入的图像文件，图标就会出现在Images框内。从图中可以看出，引入的图标被自动赋予索引号。

　　为了使用上的方便，每一个图标都有一个编号，这个编号就是这个图标的索引号。如果要引用某个图标，只需要使用它的索引号就可以了。

　　要注意的是：这个编辑器会自动把引入的图像分解成16×16的图标，之所以尺寸为16×16是因为ImageList的属性Width和Height被设置成了16。如果图标的尺寸不一样，那么可以修改这两个属性，使其满足图标的要求。

　　然后、继续用项目编辑器给节点增加图标：我们已经在图标列表组件中加入了两个图标，其索引号分别为0和1，接着可以使用项目编辑器给节点增加图标。

　　再次打开项目编辑器，输入所有节点。

　　修改节点的ImageIndex, SelectedIndex属性，

　　要注意的是，编辑框Image Index中的索引号是0，编辑框Selected Index中的索引号是1。也就是说，在选中或未选中状态下，该节点显示的图标不同。

　　修改所有节点的图标索引号，使包含子节点的节点有两种不同的图标，而不含子节点的节点只有一种图标，也就是编辑框Image Index和Selected Index的索引号相同。

　　最后，修改TreeView1组件的Images属性，从下拉列表中选择ImageList1组件。

　　从屏幕上可以看到，图标已经出现在控件里面了。

　　51）问：那怎样给节点增加第二个图标呢？

　　答：要给节点增加第二个图标，首先必须再创建一个图标列表组件，然后把这个图标列表赋值给TreeView组件的属性StateImages。当然还要给这个图标列表引入图标。

　　完成这些工作后，我们就可以进入项目编辑器，选中要增加第二个图标的节点，修改编辑框State Index中的索引号即可。

　　52）问：TreeView有哪些重要的函数呢？

　　答：AlphaSort：其声明为：bool _fastcall AlphaSort(void)；这个函数用来对所有的节点按标签的字母顺序排序。若排序成功，则返回true。

　　FullCollapse：其声明为void _fastcall FullCollapse(void)；这个函数的作用是折叠所有的节点，直到最顶层为止。

　　FullExpand：其声明为 void _fastcall FullExpand(void)；这个函数的作用是展开所有的节点，直到最底层为止。若ShowButtons属性为true，则所有的“+”都会变成“-”。

　　GetHitTestInfoAt：其声明为THitTests _fastcall GetHitTestInfoAt(int X,int Y)；这个函数返回指定点与树状视图之间的位置关系。这个点的位置由参数X、Y确定。THitTests是个集合，它可能包含下面的元素：

　　HtAbove：在树状视图的客户区上方；

　　HtBelow：在树状视图的客户区下方；

　　HtNowhere：在树状视图的客户区内但在最后一个节点下面；

　　HtOnItem：在某个节点的标签或者图标上；

　　HtOnButton：在某个节点的左边的图标上；

　　HtOnIcon：在某个节点的图标上；

　　HtOnIndent：在某个节点的缩进线上；

　　HtOnLabel：在某个节点的标签上；

　　htOnRight：在某个节点的右边；

　　htOnStateIcon：在某个节点的状态图标上；

　　htToLeft：在客户区的右边；

　　htToRight：在客户区的的左边。

　　GetNodeAt：其声明为TTreeNode*_fastcall GetNodeAt(int X,int Y)；这个函数用来返回指定点所在的节点。参数X、Y为这个点的坐标。如果这个点没有节点，则返回NULL