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://net2asp.com/dec2a75d6b.html
