一款面向对象的开源 WPF TreeView 树控件

摘要：WPF 开发中，TreeView 控件的使用一直让开发们头疼不已。网上充斥着各种五花八门的解决方案，从复杂的自定义模板到繁琐的数据绑定，开发为了实现一个功能完整的 TreeView 控件，常常需要投入大量的时间和精力，绞尽脑汁。然而，至今仍没有一个统一的、完整

WPF 开发中，TreeView 控件的使用一直让开发们头疼不已。网上充斥着各种五花八门的解决方案，从复杂的自定义模板到繁琐的数据绑定，开发为了实现一个功能完整的 TreeView 控件，常常需要投入大量的时间和精力，绞尽脑汁。然而，至今仍没有一个统一的、完整的、易于使用的封装方案。

本文推荐一套面向对象的 TreeView 封装库让大家从繁琐的细节中解放出来，专注于业务逻辑的实现。

项目介绍

项目提供一套完整的、面向对象的树节点操作方式。它摒弃了传统 TreeView 开发中复杂的模板定义、数据绑定和事件处理，为大家提供了一种简洁、高效的开发模式。

通过该封装库，可以更加轻松地构建功能强大的 TreeView 控件，提升开发效率。

项目功能1、完整的树形结构管理

支持节点的创建、删除、遍历等基础操作，方便开发者对树形结构进行灵活管理。

2、复选框系统

具备三态管理、自动级联、状态查询等功能，满足复杂业务场景下对节点选择的需求。

3、右键菜单系统

树级别和节点级别菜单，支持快捷键设置，增强用户交互体验。

4、样式配置系统

可对图标、颜色、字体等视觉元素进行定制，使 TreeView 控件更加美观。

5、选择管理

支持多选，并能跟踪选择状态，方便开发者获取用户的选择信息。

6、复制功能

能够完整复制节点结构，便于数据的复制和迁移。

7、数据绑定

可关联自定义数据对象，实现数据的灵活展示和管理。

8、树形结构多选

支持通过 Shitf/Ctrl/Ctrl+A 对树节点进行多选，提升用户操作的便捷性。

项目效果

演示动画

项目使用1、通过包管理器控制台安装Install-Package Su.WPF.TreeViewEx
2、通过 .NET CLI 安装dotnet add package Su.WPF.TreeViewEx
3、通过 Visual Studio 包管理器安装

右键点击项目 → 管理 NuGet 程序包

搜索 Su.WPF.TreeViewEx

点击安装

4、包引用 (csproj)PackageReference Include="Su.WPF.TreeViewEx" Version="1.0.0" />
项目核心1、基本树结构创建// 创建根节点
var root = TreeNodeEx.CreateNode("我的项目");

// 添加子节点
var srcFolder = root.AddChild("源代码");
srcFolder.AddChild("MainWindow.xaml.cs");
srcFolder.AddChild("MainViewModel.cs");

// 批量添加
root.AddRange(new
{
TreeNodeEx.CreateNode("文档"),
TreeNodeEx.CreateNode("资源")
});
2、图标配置var node = TreeNodeEx.CreateNode("带图标的节点");

// 设置图标和大小
node.TreeNodeExIconOptions.Icon = yourImageSource;
node.TreeNodeExIconOptions.Width = 20;
3、文本样式配置var titleNode = TreeNodeEx.CreateNode("标题");
titleNode.TreeNodeExTextOptions.FontSize = 16;
titleNode.TreeNodeExTextOptions.FontWeight = FontWeights.Bold;
4、复选框系统var parent = TreeNodeEx.CreateNode("父节点");
parent.IsShowCheckBox = true;

var child = parent.AddChild("子节点");
child.IsShowCheckBox = true;
child.IsChecked = true;
5、菜单系统与快捷键

树级别菜单（支持快捷键）

// 基本快捷键
var refreshMenu = new TreeViewMenu("刷新", RefreshAction)
{
Shortcut = new MenuShortcut(ModifierKeys.Control, Key.R)
};

// 组合快捷键
var saveMenu = new TreeViewMenu("保存", SaveAction)
{
Shortcut = new MenuShortcut(ModifierKeys.Control | ModifierKeys.Shift, Key.S)
};

provider.Controller.Options.MenuItemModels.Add(refreshMenu);
provider.Controller.Options.MenuItemModels.Add(saveMenu);

节点级别菜单

var fileNode = TreeNodeEx.CreateNode("文件");
fileNode.MenuItemModels.Add(
new TreeNodeMenu("打开", node => OpenFile(node))
);
6、高级查询功能// 复制节点
var copiedNode = originalNode.Copy;

// 复选框状态查询
var checkedNodes = parent.GetCheckedChildren;
var allCheckedDescendants = parent.GetAllCheckedDescendants;
var hasCheckedChildren = parent.HasCheckedChildren;
项目技术框架支持

本封装库支持以下框架版本：

.NET Framework 4.5 及以上

.NET Core 3.1 及以上

.NET 5.0（仅限 Windows 桌面应用）及以上

这意味着你可以在 WPF 或 WinForms 桌面应用中直接使用，无需额外适配。

项目源码

NuGet 包: Su.WPF.TreeViewEx

Gitee：https://gitee.com/SususuChang/su.-wpf.-custom-control

GitHub：https://github.com/ViewSuSu/Su.WPF.TreeViewEx

总结

项目基于 SOLID 原则的架构，采用面向对象设计思想，严格遵循开闭原则，对扩展开放，对修改关闭，具有单一职责和接口隔离的特点。

该封装库的设计哲学是"简单不应该复杂，复杂不应该简单"，常用功能开箱即用，高级功能可扩展，错误使用编译时报错，架构设计面向未来。