C# 控件基础2——属性配置控件PropertyGrid使用详解,PropertyGrid自定义下拉框TypeConverter,PropertyGrid自定义弹窗UITypeEditor,特性

前言

  • 最近比较忙,一段时间没写博文了。最近仿vs做了一个自定义界面的功能,使用到了PropertyGrid控件,让我的代码量减少了很多,就抽个晚上把PropertyGrid控件的使用技巧分享一下。
  • PropertyGrid控件估计大家都很熟悉,但凡使用winform开发过界面的都认识,就是配置控件属性的控件,如下图:

在这里插入图片描述

用途

当然,以上只是vs软件的功能,我们如果想要实现类似vs的这个功能,其实官方已经帮我们封装好了,拖出来用就行了。只要给PropertyGrid控件的SelectedObject属性绑定对象,该对象的所有属性都会自动显示在PropertyGrid控件的网格中,进而可以配置。下面展示一下我的使用:

在这里插入图片描述

PropertyGrid属性介绍

  • PropertyGrid的属性很多,我们需要使用的也很多。由于篇幅有限,我就挑几个重要的说一下,需要用到的同学还得自己去了解仔细:
  • SelectedObject:所绑定的单个对象;
  • HelpVisible:显示属性描述区域,对应特性Description的内容;
  • SelectedObjects:绑定多个对象,展示他们同名属性。

PtopertyGrid事件介绍

  • 同样,挑常用的几个:
  • PropertyValueChanged:这个事件很重要,当我们修改PtopertyGrid网格里面的内容(当前绑定的对象的值)时,这个事件会触发,我们相应需要把一下逻辑写到这个事件的实现里面。

基础特性

  • 当我们想给某属性添加某些修饰或者限制时,可以通过特性来完成。当然,PtopertyGrid控件也能根据该特性做些改变

    在这里插入图片描述

  • BrowsableAttribute:在PtopertyGrid控件中显示属性,属性默认显示,当该特性设为false时不显示;

  • Category:在PtopertyGrid控件中分类,如上图的“关联信息”、“外观”等类型,可以把某些属性归类;

  • DisplayName:在PtopertyGrid控件中名字,如上图的“文字位置”、“文本”、“宽高”等信息;

  • Description:在PtopertyGrid控件中对选中属性的描述,如上图最底下的文字;

  • 当然还可以自定义特性,有兴趣的同学可以深入了解一下

高级特性(自定义下拉框)

  • TypeConverter:类型转换,将任意类型转换成另一种类型,是它帮助我们实现自定义下拉框配置属性值,这个特性是本文章重点。

    在这里插入图片描述

  • 如上图,工程名称属性就使用了自定义下拉框,配置属性非常方便;
        ///         /// 当前工程名称        ///         [Browsable(true), DisplayName("工程名称"), Category("关联信息"), Description("关联所选工程"),            TypeConverter(typeof(PojNameType))]        public string ProjName
  • 如上代码,其中“TypeConverter(typeof(PojNameType))”中的PojNameType是我自定义的类型转换器,继承自StringConverter,当然也可以继承TypeConverter等。这里是使字符串对象与其他表示形式之间相互转换,所以使用StringConverter。
  • 如果Converter是用于该属性的类型uint与用于显示的类型string之间的转换,Converter是用于该属性的类型uint与用于显示的类型string之间的转换;ConvertFrom是string转换成uint;
  • 通过以下代码实现自定义下拉框:
///     /// 输入链接所选工程名称    ///     public class PojNameType : StringConverter    {        List allToolName = new List { };        //重写,支持从标准模板中选中值作为返回值        public override bool GetStandardValuesSupported(ITypeDescriptorContext context)        {            return true;        }        //重写,提供转换器并        public override StandardValuesCollection GetStandardValues(ITypeDescriptorContext context)        {            allToolName.Clear();            //遍历提取传进编辑界面的所有流程            if (context.Instance is LinkProjControlBase)            {                LinkProjControlBase linkProjControlBase = context.Instance as LinkProjControlBase;                foreach (var item in linkProjControlBase.ProjNameToIntptr)                {                    allToolName.Add(item.Key);                }            }            return new StandardValuesCollection(allToolName); //编辑下拉框中的items        }        //重写,不支持编辑文本(true为不支持)        public override bool GetStandardValuesExclusive(ITypeDescriptorContext context)        {            return false;        }    }

高级特性(自定义弹窗)

  • Editor:编辑器,当我们想实现自定义弹窗的编辑器时,使用这个可以帮助我们,当然其不仅仅等实现弹窗,下拉框也可以实现;

    在这里插入图片描述

  • 如上图,自定义一个选择项目的弹窗,来配置属性。
        ///         /// 链接的工具名称,选中相同的无法触发Set,即无法更新ToolIntptr        ///         [Browsable(true), Category("关联信息"), Description("关联的工具名称"), Editor(typeof(ToolNameItemsType), typeof(UITypeEditor))]        public string ToolName
  • 以上代码是使用Editor的特性方法,其中ToolNameItemsType是自定义弹窗类型转换器,继承UITypeEditor
	///     /// 继承UITypeEditor类,弹窗形式选择    /// 链接工具名称—单工具    ///     public class ToolNameItemsType : UITypeEditor    {        public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext context)        {            return UITypeEditorEditStyle.Modal;        }        public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)        {            List allToolName = new List();            if (context != null && context.Instance is LinkToolControlBase)            {                //类型转换                LinkToolControlBase toolControl = context.Instance as LinkToolControlBase;                                allToolName = new List(toolControl.toolNameAll.ToArray());            }            IWindowsFormsEditorService edSvc = (IWindowsFormsEditorService)provider.GetService(typeof(IWindowsFormsEditorService));            if (edSvc != null)            {                //弹窗选择                FrmSelectTool f = new FrmSelectTool(allToolName);                edSvc.ShowDialog(f);                //赋值属性                value = f.SelectName;            }            return value;        }    }

结论

  • PropertyGrid在软件开发中,能帮省略很多代码,用起来非常方便
  • Converter用于处理输入值时的行为,常用于有效性验证、格式转换等,而Editor用于处理下拉或打开新窗口时的行为。它们可以在同一个属性上共存。
  • 后面再写一篇关于自定义界面布局的文章剖析PropertyGrid的妙处

注:

转载本文需要标明出处!

谷子彭:1062484747@163.com

本文来自网络,不代表协通编程立场,如若转载,请注明出处:https://www.net2asp.com/dec2a75d6b.html