转贴自MS：扩展 TreeView 控件（1）

2024-07-21 02:24:18

字体：大中小

来源：转载

供稿：网友

windows 窗体控件开发示例
duncan mackenzie
microsoft developer network
2002 年 5 月

摘要：讲述了如何向 treeview 控件添加数据绑定功能，它是一系列 microsoft windows 控件开发示例之一。您可以将本文与相关的概述文章结合起来阅读。
您可以从 msdn code center 下载 winformcontrols.exe（英文）源代码。（请注意，在示例文件中，程序员的注释使用的是英文，本文中将其译为中文是为了便于读者理解。）
本文是介绍如何在 microsoft® .net 中开发控件的系列文章中的第四篇（共五篇）：

developing custom windows controls using visual basic .net (overview)（英文）
adding regular expression validation（英文）
combining multiple controls into one（英文）
扩展 treeview 控件
drawing your own controls using gdi+（英文）

简介

在可能的情况下，您应该先使用些现成的控件；因为提供的 microsoft® windows® 窗体控件中包含大量编码和测试成果，如果您要放弃它们从头开始，无疑是一种巨大的浪费。基于此，在本例中，我将继承一个现有 windows 窗体控件 treeview ，然后对其进行自定义。在下载该 treeview 控件的代码时，您还会得到附加的控件开发示例，以及一个演示如何与其他数据绑定控件一起使用该增强 treeview 的示例应用程序。

设计数据绑定树视图

对于 windows 开发人员来说，向 treeview 控件添加数据绑定是经常会遇到的问题，但由于 treeview 和其他控件（如 listbox 或 datagrid）存在一个主要差别（即 treeview 显示分层数据），因而基本控件目前还不支持此功能（也就是说，我们还必须使用它）。给定一个数据表，您就会很清楚如何在 listbox 或 datagrid 中显示该信息，但利用 treeview 的分层特点来显示同样的数据就不那么简单明了。就个人而言，我在使用 treeview 显示数据时曾应用过许多不同的方法，但有一种方法最常用：按某些字段将表中的数据分组，如图 1 所示。

图 1：在 treeview 中显示数据
在本例中，我将创建一个 treeview 控件，在该控件中可传递一个平面数据集（如图 2 所示），并可轻松地生成图 1 所示的结果。

图 2：平面结果集，包含创建图 1 所示的树所需的所有信息
在开始编码之前，我为新控件想出了一个可以处理该特定数据集的设计，并希望它能够适用于许多其他类似的情形。添加一个足可以使用大多数平面数据创建分层结构的组集合，在该集合中为每一级分层均指定一个分组字段、显示字段和值字段（任一或所有字段均应相同）。为了将图 2 所示的数据转变成图 1 所示的 treeview，我的新控件要求您定义两个分组级别 publisher 和 title，并将 pub_id 定义为 publisher 组的分组字段，将 title_id 定义为 title 组的分组字段。除分组字段以外，还需要为每个组指定显示和值字段，以确定在相应组节点上显示的文本以及用来唯一标识特定组的值。当遇到此类数据时，请使用 pub_name/pub_id 和 title/title_id 作为这两个组的显示/值字段。作者信息将变成树的叶节点（分组分层结构末端的节点），您还需要为这些节点指定 id (au_id) 和显示 (au_lname) 字段。
构建自定义控件时，在开始编码之前确定程序员对该控件的使用方法将有助于提高控件的使用效率。这种情况下，我希望程序员（在给定了前面所示的数据和所需结果的情况下）能够使用如下几行代码完成分组：

        with dbtreecontrol            .valuemember = "au_id"            .displaymember = "au_lname"            .datasource = mydatatable.defaultview            .addgroup("publisher", "pub_id", "pub_name", "pub_id")            .addgroup("title", "title_id", "title", "title_id")        end with

注意：这并不是我最终编写的代码行，但两者相差不多。在开发控件的过程中，我意识到需要将与 treeview 关联的 imagelist 中的图像索引与每个分组级别相关联，因此必须向 addgroup 方法中额外添加一个参数。

为了真正构建该树，我将浏览数据并查找字段（指定为每个分组的分组值）的更改，同时在必要时创建新分组节点，并针对每个数据项创建一个叶节点。由于存在分组节点，因此总节点数将大于数据源中的项目数，但基础数据中的每个项有且仅有一个叶节点。

图 3：分组节点与叶节点
叶节点和分组节点之间的区别（如图 3 所示）对本文的余下部分具有重要意义。我决定将这两类节点区别对待，为每一类节点分别创建自定义节点，并根据所选的节点类型引发不同的事件。

实现数据绑定

为该控件编写代码的第一步是创建项目和相应的起始类。在本例中，我首先创建一个新 windows 控件库，然后删除默认的 usercontrol 类，并用一个从 treeview 控件继承的新类来代替它：

public class dbtreecontrol    inherits system.windows.forms.treeview

从这时起，我将设计一个可以放入到窗体中的控件，并使其具有常规的 treeview 的外观和功能。下一步是开始添加旨在处理在 treeview 中加入的新功能所需的代码，即数据绑定和分组数据。

添加 datasource 属性

我的新控件的所有功能都很重要，但构建复杂数据绑定控件的两个关键问题是处理 datasource 属性和从数据源的每个对象中检索单个项目。

创建属性例程

首先，任何用于实现复杂数据绑定的控件都需要实现一个 datasource 属性例程，并保持适当的成员变量：

private m_datasource as object<category("data")> _public property datasource() as object    get        return m_datasource    end get    set(byval value as object)        if value is nothing then            cm = nothing            groupingchanged()        else            if not (typeof value is ilist or _                      typeof value is ilistsource) then                ' 不是针对该用途的有效数据源                throw new system.exception("无效 datasource")            else                if typeof value is ilistsource then                    dim mylistsource as ilistsource                    mylistsource = ctype(value, ilistsource)                    if mylistsource.containslistcollection = true then                        throw new system.exception("无效 datasource")                    else                        ' 对，对。它是有效的数据源                        m_datasource = value                        cm = ctype(me.bindingcontext(value), _                            currencymanager)                        groupingchanged()                    end if                else                    m_datasource = value                    cm = ctype(me.bindingcontext(value), _                        currencymanager)                    groupingchanged()                end if            end if        end if    end setend property

ilist 接口

可用作复杂数据绑定数据源的对象通常都支持 ilist interface（英文），该接口将数据公开为对象集合，并提供若干有用属性，如 count。我的新 treeview 控件要求在其绑定中使用一个支持 ilist 的对象，但使用另一个接口 ilistsource interface（英文）也可以，因为它提供了一个获取 ilist 对象的简便方法 (getlist)。当设置 datasource 属性后，我首先确定是否提供了有效的对象，即一个支持 ilist 或 ilistsource 的对象。我真正想要的是 ilist，因此如果对象仅支持 ilistsource（例如 datatable），那么我将使用该接口的 getlist() 方法获得正确的对象。
某些实现 ilistsource 的对象（如 dataset）实际上包含多个由 containslistcollection 属性表示的列表。如果该属性为 true，则 getlist 将返回一个表示列表（包含多个列表）的 ilist 对象。在我的示例中，我决定支持直接连接到 ilist 对象或仅包含一个 ilist 对象的 ilistsource 对象，并忽略需要附加工作来指定数据源的对象，如 dataset。