PropertyGrid控件由浅入深(二):基础用法

目录

  1. PropertyGrid控件由浅入深(一):文章大纲
  2. PropertyGrid控件由浅入深(二):基础用法

控件的外观构成

控件的外观构成如下图所示:

PropertyGrid控件由浅入深(二):基础用法_第1张图片

PropertyGrid控件包含以下几个要素:

  • 属性名称
    属性的名称、标题。
  • 属性编辑器(属性值)
    这里显示的是属性的当前值,显示的一般为文字,也可以以图标的形式。编辑器会自动根据数据的类型定义一个验证器,比如属性类型为int类型,你是无法输入字符内容的。另外,一般属性的编辑是直接在属性值这栏直接输入,但是复杂的属性,一般都会提供一个自定义的属性编辑器以便更友好的输入,比如颜色选择。
  • 属性说明(描述)
    属性的详细描述。
  • 可展开属性
    对象属性的展示,以便都是显示对象属性的名称,以及对象属性的值的.ToString()方法。除非,你设置这个属性的特性Attribute为可展开属性TypeConverter(typeof(ExpandableObjectConverter))。具体用法查看下一篇的“高级用法
  • 属性分组
    属性较多时,通过分组的形式,可以很容易的对属性进行良好的组织。最常用的,就是我们在扩展一个控件的属性时,可以给自定义出来的属性打上一个分组标签“xx公司自定义属性”,这样,别人在用你这个自定义控件的属性时,就非常容易查看到哪些属性是扩展上去的了。
  • 属性的排序方式:按字母顺序还是按分组排序
    可以选择按字面顺序排序、还是按分组排序来显示所有的属性,方便查找。在实际运用中,一般都是按分组显示的。如果你对控件应用很熟悉了,已经知道有哪些属性了,按字母排序,会加快你查找的速度。

控件的基本属性

PropertyGrid控件继承控件基类:Contorl,因此会包含Contorl的所有属性,这里就不详细的一一介绍了。

我们主要看看PropertyGrid特有的几个属性:

  • SelectedObject
    当前所绑定的对象
  • HelpVisible
    属性描述区域是否显示
  • HelpBackColor
    属性描述区域的背景颜色
  • HelpForeColor
    属性描述区域的前景颜色
  • CategoryForeColor
    属性分组标题的前景颜色
  • ToolbarVisible
    工具栏是否可见
  • LargeButtons
    属性可以显示大工具栏按钮

控件的基本事件

同样,我们只关心其中最常用的事件:PropertyValueChanged。即当属性变化时触发的事件。

这个事件包括两个参数:

  • object sender
    这里就是PropertyGrid控件
  • PropertyValueChangedEventArgs e
    我们查看下VS调试状态这个值的属性
    PropertyGrid控件由浅入深(二):基础用法_第2张图片
    其中包含了两个重要的属性:OldValueChangeItem。而ChangeItem则是“PropertyDescriptorGridEntry”类型。

    一般可以通过ChangeItem的PropertyDescriptor的ComponentType查找到属性的实际类型。

    而通过ChangeItem的Label,则可以查看到当前在属性编辑输入框中显示的值。

    通过ChangeItem,基本可以处理所有的属性变化的处理。

控件的对象绑定

控件的对象绑定非常非常简单,只需一句话即可:propertyGrid1.SelectedObject = stu;

每次设置 SelectedObject 时,PropertyGrid 都会刷新显示的属性。这提供了一种简单的方法来强制刷新属性,或在运行时切换对象。您还可以调用 PropertyGrid.Refresh 方法来刷新属性。

这里还有另外一个有意思的属性:propertyGrid1.SelectedObjects = new object[] { stu, emp };。一般人可能不太理解这个的意思,而且在使用了这个绑定之后,有时竟然一个属性都不出现了!

其实:propertyGrid1.SelectedObjects是用来显示多个对象公用属性的,参考MSDN的文档:

The PropertyGrid only displays the properties that are common to all the objects that are in the array. Assigning an array to the SelectedObjects replaces the reference to any SelectedObject you might make.

比如我有如下两个对象:

public class Employee
{
    public string Company { get; set; }
    public string Name { get; set; }
}
public class Student
{
    public string Name { get; set; }
    public SchoolType SchoolType { get; set; }
}

那么绑定这两个对象到PropertyGrid控件会发生什么呢?

        var stu = new Student { Name = "Oracle", SchoolType = SchoolType.MiddleSchool };
        var emp = new Employee { Name = "Marvin", Company = "IBM" };

        propertyGrid1.SelectedObjects = new object[] { stu, emp };

我们看看最终的结果:

PropertyGrid控件由浅入深(二):基础用法_第3张图片

如何更改属性的展示

在使用propertyGrid1.SelectedObject = stu;绑定属性到对象之后,我们发现,属性的名称总是英文的名称,描述也是不按我们的意思来,那么怎么修改呢?

PropertyGrid采用Attribute特性来控制属性的显示,除了属性名称、描述之后,还能控制属性是否只读、属性是否显示等等。具体可用的特性枚举如下:

  • DescriptionAttribute - 设置显示在属性下方说明帮助窗格中的属性文本。这是一种为活动属性(即具有焦点的属性)提供帮助文本的有效方法。
  • CategoryAttribute - 设置属性在网格中所属的类别。当您需要将属性按类别名称分组时,此特性非常有用。如果没有为属性指定类别,该属性将被分配给杂项 类别。
  • BrowsableAttribute – 表示是否在网格中显示属性。此特性可用于在网格中隐藏属性。默认情况下,公共属性始终显示在网格中。
  • ReadOnlyAttribute – 表示属性是否为只读。此特性可用于禁止在网格中编辑属性。默认情况下,带有 get 和 set 访问函数的公共属性在网格中是可以编辑的。
  • DefaultValueAttribute – 表示属性的默认值。如果希望为属性提供默认值,然后确定该属性值是否与默认值相同,则可使用此特性。
    注意,此属性仅用于序列化以及控件本身使用,并不实际对属性进行默认值赋值。也就是,即使你设置了DefaultValue,在实际运行中,如果你没有在构造函数或者其他任何地方赋值,则系统不会对该属性赋值。如果你希望真正的给个默认值,则需要在构造函数中进行默认值的赋值。

    参考stackoverflow:
    [DefaultValue] is only used by (for example) serialization APIs (like XmlSerializer), and some UI elements (like PropertyGrid). It doesn't set the value itself; you must use a constructor for that:
  • DefaultPropertyAttribute – 表示类的默认属性。在网格中选择某个类时,将首先突出显示该类的默认属性。

参考示例:

public class Student
{
    [Browsable(false)]
    public int Id { get; set; }

    [DisplayName("学生名称"), Category("基础设置"), Description("请填写学生的名称,不能为空"), ReadOnly(true)]
    public string Name { get; set; }

    [DefaultValue(SchoolType.University)]
    public SchoolType SchoolType { get; set; }
}

PropertyGrid控件由浅入深(二):基础用法_第4张图片

参考文章:

  1. .Net DefaultValueAttribute on Properties
  2. DefaultValue not working as expected when used with Custom Type Convertor
  3. C# PropertyGrid控件应用心得

你可能感兴趣的:(PropertyGrid控件由浅入深(二):基础用法)