使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

在一些字典绑定中,往往为了方便展示详细数据,需要把一些结构树展现在树列表TreeList控件中或者下拉列表的树形控件TreeListLookUpEdit控件中,为了快速的处理数据的绑定操作,比较每次使用涉及太多细节的操作,我们可以把相关的数据绑定操作,放在一些辅助类的扩展函数中进行处理,这样可以更方便的,更简洁的处理数据绑定操作,本篇随笔介绍TreeList控件和TreeListLookUpEdit控件在扩展函数中的处理操作。

1、TreeList控件的绑定操作

TreeList本身就是一个树形数据的展示控件,可以展示常规的二维表,也可以展示具有嵌套关系的二维表,数据源可以是多种方式的,支持Datable的数据源的嵌套展示。

单个列信息的树形列表展示界面效果:

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

 类似GridView的嵌套列表展示的TreeList界面效果

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

 这些界面都比较常见,也是我们经常碰到的处理效果,但是TreeList的界面设置有很多特性,如果每次拷贝这些代码,需要很多,也不便于维护,因此我们建立一些扩展函数来处理界面元素的绑定,就非常必要。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

本篇随笔介绍基于TreeList和TreeListLookUpEdit控件的绑定即可。两个类型控件的数据源,都可以是DataTable类型,也可以是IList集合类型,如下所示是基于SQLSugar开发框架,返回的数据结构是IList类型的。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

所以一般树形列表的绑定操作,提供一个方法来获取数据并绑定即可。

        /// <summary>
        /// 绑定树的数据源
        /// </summary>
        private async void BindTree()
        {
            var list = await BLLFactory<IDictTypeService>.Instance.GetAllAsync();
            this.tree.DataSource = list?.Items;
            this.tree.ExpandAll();
        }

如果使用原生代码初始化树列表,那么代码如下所示。

 //使用原生代码处理
 //添加显示列
 this.tree.Columns.Add(new TreeListColumn{ FieldName= "Id", Caption= "ID"});//增加一个隐藏的字段,存储需要的ID
 this.tree.Columns.Add(new TreeListColumn{ FieldName= "Name", Caption= "字典类型名称", Width=160, VisibleIndex =0});
 //设置树控件的层次关系及属性
 tree.KeyFieldName = "Id";
 tree.ParentFieldName = "PID";
 this.tree.OptionsBehavior.Editable = false;
 this.tree.OptionsView.ShowColumns = false;
 this.tree.OptionsView.ShowCheckBoxes = false;
 this.tree.OptionsView.EnableAppearanceOddRow = true;
 this.tree.OptionsView.EnableAppearanceEvenRow = true;

而实现查询过滤的操作,还需要另外处理代码,我们看看大概的代码如下。

        /// <summary>
        /// 实现树节点的过滤查询
        /// </summary>
        private void InitSearchControl()
        {
            this.searchControl1.Client = this.tree;
            this.tree.FilterNode += (object sender, FilterNodeEventArgs e) =>
            {
                if (tree.DataSource == null)
                    return;

                string nodeText = e.Node.GetDisplayText("Name");//参数填写FieldName  
                if (string.IsNullOrWhiteSpace(nodeText))
                    return;

                bool isExist = nodeText.IndexOf(searchControl1.Text, StringComparison.OrdinalIgnoreCase) >= 0;
                if (isExist)
                {
                    var node = e.Node.ParentNode;
                    while (node != null)
                    {
                        if (!node.Visible)
                        {
                            node.Visible = true;
                            node = node.ParentNode;
                        }
                        else
                            break;
                    }
                }
                e.Node.Visible = isExist;
                e.Handled = true;
            };
        }

这些是比较常见的操作,我们把它封装为扩展函数,然后根据特性传入对应参数实现即可。

最后简单的三行代码来简单处理,可以达到同样的效果就可以了。

  //控件扩展函数封装处理
  this.tree.CreateColumn("Name", "字典类型名称", 160, true);
  this.tree.InitTree("Id", "PID", "-1", false, false);
  this.tree.InitSearchControl(this.searchControl1, "Name");

我们扩展方法放在一个单独的文件中,标注为静态类即可。

    /// <summary>
    /// TreeList控件的扩展函数
    /// </summary>
    public static class TreeList_Extension

其中提供几个对TreeList 常见的封装处理方法就可以了。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

对于一些不常见的属性,我们保留它即可,如下界面代码是对TreeList绑定展示多个列的处理操作。

/// <summary>
/// 初始化TreeList控件,展现嵌套的列表。
/// </summary>
private void InitControl()
{
    this.tree.Columns.Clear();//控件扩展函数封装处理
    this.tree.CreateColumn("Name", "机构名称", 160, true);
    this.tree.CreateColumn("HandNo", "机构编码", 80, true);
    this.tree.CreateColumn("Category", "机构分类", 80, true);
    this.tree.CreateColumn("Address", "机构地址", 160, true);
    this.tree.CreateColumn("InnerPhone", "内线电话", 80, true);
    this.tree.CreateColumn("OuterPhone", "外线电话", 80, true);
    this.tree.CreateColumn("SortCode", "排序码", 80, true);
    this.tree.InitTree("Id", "PID", null, true, true);

    this.tree.OptionsView.RowImagesShowMode = RowImagesShowMode.InCell;//紧凑型图标
    this.tree.ExpandAll();

    // 列过滤处理            
    this.tree.OptionsView.ShowAutoFilterRow = true;//显示过滤行            
    this.tree.OptionsBehavior.EnableFiltering = true;//开启过滤功能

    //初始化树节点选择事件
    this.tree.FocusedNodeChanged += delegate (object sender, FocusedNodeChangedEventArgs e)
    {
        this.FocusedNodeChanged();
    };
    //树节点双击处理事件
    this.tree.DoubleClick += (s, e) =>
    {
        if (this.tree.FocusedNode != null)
        {
            string ID = string.Concat(this.tree.FocusedNode.GetValue("Id"));
            MessageDxUtil.ShowTips("Id=" + ID);
        }
    };
    //编辑记录失去焦点后校验处理
    this.tree.ValidateNode += (s, e) =>
    {
        Console.WriteLine(this.tree.FocusedNode.GetValue("Name"));
    };
}

实现类似GridView的嵌套列表展示的TreeList界面效果如下所示。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

 

2、TreeListLookUpEdit控件绑定操作

在一些参考的列表中,我们往往需要展示更丰富一点的列表内容,如下所示。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

如果有嵌套列表的,展示嵌套列表的处理

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

对于下拉的树形列表,虽然这个控件比TreeList更复杂一些,它是下拉列表和TreeList的整合体,不过我们也可以用类似的扩展函数方法,来简单的实现数据的绑定展示。

如对于常规的数据绑定,我们大概的代码如下所示。

//TreeListLookupEdit数据绑定
//this.txtProjectList3.Properties.TreeList.OptionsView.ShowCheckBoxes = true;
this.txtProjectList3.Properties.DataSource = list;
this.txtProjectList3.Properties.ValueMember = "Value";
this.txtProjectList3.Properties.DisplayMember = "Text";
this.txtProjectList3.Properties.TreeList.Columns.Clear();
for (int i = 0; i < columns.Count; i++)
{
    this.txtProjectList3.Properties.TreeList.CreateColumn(columns[i].FieldName, columns[i].Caption,
        columns[i].Width, true);
}
this.txtProjectList3.Properties.TreeList.InitTree(null, null, null, true, true);

this.txtProjectList3.Properties.ImmediatePopup = true;
this.txtProjectList3.Properties.TextEditStyle = TextEditStyles.Standard;
this.txtProjectList3.Properties.PopupWidthMode = DevExpress.XtraEditors.PopupWidthMode.ContentWidth;
this.txtProjectList3.Properties.PopupFormSize = new System.Drawing.Size(this.txtProjectList3.Width, 300);
this.txtProjectList3.Properties.TreeList.IndicatorWidth = 40;
this.txtProjectList3.Properties.TreeList.CustomDrawNodeIndicator += (s, ee) =>
{
    if (ee.IsNodeIndicator)
    {
        var index = ee.Node.TreeList.GetVisibleIndexByNode(ee.Node);
        ee.Info.DisplayText = (index + 1).ToString();
    }
};

对于常规的列表绑定,我们可以用简单的一个扩展函数实现,如下所示。

    //常规类别绑定
    this.txtProjectList4.BindDictItems(list, "Text", "Value", true, columns.ToArray());

就可以实现常规的界面效果处理。

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

对于树形列表,我们需要设置属性的ID和PID,以及一些显示的列属性,那么也可以增加更多的参数来实现。

var dictTypeColumns = new List<LookUpColumnInfo>()
{
    new LookUpColumnInfo("Id", "Id"),
    new LookUpColumnInfo("Name", "字典类别名称")
};
treeListLookUp.BindDictItems(result.Items, "Name", "Id", true, false, "Id", "PID", null, true, true, true, false, dictTypeColumns.ToArray());

因此嵌套列表就可以正常的展示出层次关系了

使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件

因此我们把扩展方法,放到静态类里面就可以了,方法封装如下所示

       /// <summary>
        /// 绑定TreeListLookUpEdit控件的数据源(完整版)
        /// </summary>
        /// <param name="lookup">控件对象</param>
        /// <param name="dataSource">数据源</param>
        /// <param name="displayMember">显示字段</param>
        /// <param name="valueMember">值字段</param>
        /// <param name="showRowIndicator">是否显示序号</param>
        /// <param name="showCheckbox">是否显示复选框</param>
        /// <param name="keyFieldName">设置父子递归关系字段-子字段,不指定则使用valueMember</param>
        /// <param name="parentFieldName">设置父子递归关系字段-父字段,不指定则不嵌套展示</param>
        /// <param name="rootValue">根节点的值</param>
        /// <param name="editable">树节点是否可以编辑</param>
        /// <param name="showColumnHeader">是否显示列头</param>
        /// <param name="oddEvenRowColor">是否奇偶行不同颜色</param>
        /// <param name="allowDrop">是否运行拖动列</param>
        /// <param name="lookUpColumnInfos">显示的列</param>
        /// <returns></returns>
        public static object BindDictItems(this TreeListLookUpEdit lookup, object dataSource, string displayMember, string valueMember, bool showRowIndicator = true,
            bool showCheckbox = false, string keyFieldName = null, string parentFieldName = null, string rootValue = null, bool editable = true,
            bool showColumnHeader = false, bool oddEvenRowColor = true, bool allowDrop = false,
            params LookUpColumnInfo[] lookUpColumnInfos)
        {
            lookup.Properties.DataSource = dataSource;
            lookup.Properties.DisplayMember = displayMember;
            lookup.Properties.ValueMember = valueMember;
            lookup.Properties.TreeList.OptionsView.ShowCheckBoxes = showCheckbox;

            lookup.Properties.TreeList.Columns.Clear();
            for (int i = 0; i < lookUpColumnInfos.Length; i++)
            {
                lookup.Properties.TreeList.CreateColumn(lookUpColumnInfos[i].FieldName, lookUpColumnInfos[i].Caption,
                    lookUpColumnInfos[i].Width, true);
            }

            //初始化树的样式和特性
            //keyFieldName = !string.IsNullOrWhiteSpace(keyFieldName) ? keyFieldName : valueMember;//如果不指定,采用valueMember
            lookup.Properties.TreeList.InitTree(keyFieldName, parentFieldName, rootValue, editable, showColumnHeader, oddEvenRowColor, allowDrop);
            lookup.Properties.PopupFormSize = new System.Drawing.Size(lookup.Width, 300);

            lookup.Properties.ImmediatePopup = true;
            lookup.Properties.TextEditStyle = TextEditStyles.Standard;

            if (showRowIndicator)
            {
                lookup.Properties.TreeList.IndicatorWidth = 40;
                //重写序号显示,默认不显示数值
                lookup.Properties.TreeList.CustomDrawNodeIndicator += (s, ee) =>
                {
                    if (ee.IsNodeIndicator)
                    {
                        var index = ee.Node.TreeList.GetVisibleIndexByNode(ee.Node);
                        ee.Info.DisplayText = (index + 1).ToString();
                    }
                };
            }

            return dataSource;
        } 

通过扩展方法的方式,可以简化界面的处理代码,同时利于我们在项目开发的时候,快速的实现相关的效果,而不需要过多的中断查找相关的界面控件属性。

有几篇类似的文章,可供参考:

在Winform开发中,我们使用的几种下拉列表展示字典数据的方式

在Winform开发框架中下拉列表绑定字典以及使用缓存提高界面显示速度

在各种开发项目中使用公用类库的扩展方法,通过上下文方式快速调用处理函数

 

原文链接:https://www.cnblogs.com/wuhuacong/p/17353173.html

本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:使用扩展函数方式,在Winform界面中快捷的绑定树形列表TreeList控件和TreeListLookUpEdit控件 - Python技术站

(0)
上一篇 2023年4月30日
下一篇 2023年4月30日

相关文章

  • C#实现自定义windows系统日志的方法

    下面是详细的攻略: C#实现自定义Windows系统日志的方法 概述 Windows有一个事件记录器,可以用来记录系统和应用程序事件。这种记录方式称为Windows Event Log。通过使用C#编程语言,我们可以自定义一个事件日志,将自定义的事件写入Windows Event Log中。 步骤 以下是我们自定义事件日志的完整步骤: 1.创建自定义事件日志…

    C# 2023年6月7日
    00
  • C#实现单例模式的6种方法小结

    C#实现单例模式的6种方法小结 什么是单例模式? 单例模式是一种软件设计模式,它限制了某个类只能有一个实例,并且该实例可以从全局访问。单例模式通常用于控制资源的共享,并且可以避免竞态条件(race condition)。 单例模式的优点 单例模式可以保证某个类在全局范围内只有一个对象实例,这可以减少系统中的内存占用和资源消耗 单例模式可以确保某些操作只会被执…

    C# 2023年5月15日
    00
  • asp.net微信开发(已关注用户管理)

    ASP.NET微信开发(已关注用户管理) 简介 随着微信的用户量不断攀升,越来越多的企业希望能够通过微信进行一系列的营销活动,因此微信开发变得越来越流行。而ASP.NET作为一种成熟的web框架,非常适合进行微信开发,下面我们就来讲解一下在ASP.NET下如何进行已关注用户管理的微信开发。 步骤 1.注册微信公众号并获取公众号相关信息 首先,在微信公众平台官…

    C# 2023年6月1日
    00
  • openfiledialog读取txt写入数据库示例

    下面是“openfiledialog读取txt写入数据库示例”的完整攻略。 1. 准备工作 在开始编写代码之前,我们需要做一些准备工作: 安装并配置好数据库软件(比如 MySQL 或 SQLite),并创建一个数据库和相关的表结构; 创建一个能够与数据库进行连接的程序,并引入第三方库(比如 pymysql)作为驱动; 准备一个包含数据的 txt 文本文件; …

    C# 2023年5月15日
    00
  • C#实现六大设计原则之迪米特法则

    C#实现六大设计原则之迪米特法则 什么是迪米特法则 迪米特法则,也被称为最少知识原则(Least Knowledge Principle),是面向对象编程中的一个重要原则。 迪米特法则的定义为:只与你直接的朋友通信,不跟陌生人说话。 简而言之,就是一个对象应该对其他对象有尽可能少的了解。 也就是说,当我们设计一个系统时,每个对象都应该尽量减少和其他对象之间的…

    C# 2023年6月7日
    00
  • 详解如何通过C#/VB.NET调整PDF文档页边距

    请参考以下完整攻略: 1. 安装依赖库 要使用C#/VB.NET调整PDF文档页边距,我们需要使用一个PDF库来操作PDF文档。这里我们使用iTextSharp库来进行操作。在Visual Studio中打开项目,右键单击项目,然后选择“管理NuGet包”。在NuGet包管理器中搜索“iTextSharp”,然后离线安装。 2. 加载PDF文档 使用iTex…

    C# 2023年6月6日
    00
  • Unity报错InvalidOperationException: out of sync的解决

    针对Unity报错InvalidOperationException:outofsync的解决,我们可以采取以下步骤: 步骤1:清理Unity资源和缓存 首先我们可以尝试清理Unity的资源和缓存,方法如下: 关闭Unity编辑器。 在项目文件夹下找到 Library 文件夹,将其删除。 重新启动Unity编辑器,等待它重新构建项目的 Library 文件夹…

    C# 2023年5月14日
    00
  • C#实现的几种委托方式介绍

    下面是“C#实现的几种委托方式介绍”的完整攻略。 1. 委托的概念 委托(Delegate)是一种类型,它定义了一个方法(或一组方法)的参数类型和返回值类型。委托可以看做是函数的“指针”,它允许我们将方法作为参数传递,并且可以通过委托调用传递的方法。 2. 委托的定义 在 C# 中,委托定义的格式如下: delegate 返回类型 委托名称(参数类型 参数名…

    C# 2023年6月7日
    00
合作推广
合作推广
分享本页
返回顶部