PropertyGrid--基本功能

时间：2015-01-15 23:31:57 阅读：185 评论：0 收藏：0 [点我收藏+]

标签：

一.引言

　　PropertyGrid是Visual Studio中新增的控件，顾名思义，其主要是用来显示和设置某一（或多个）对象的属性值的。其具体的实现主要是基于.Net中强大的反射机制。PropertyGrid功能十分的强大，本人能力有限，集MSDN及丰富的网络资源，略窥一斑，虽晓之甚少，亦不敢掩藏，呈之于文，抛砖引玉。

二．PropertyGrid基本功能

1. PropertyGrid简介

　　使用PropertyGrid非常简单，这得感谢微软的技术大牛们，控件已经封装的非常完美，拿来就用，以下是MSDN中对PropertyGrid的介绍：

　　（1）要使用PropertyGrid，应在父控件上创建 PropertyGrid 类的新实例，并将 SelectedObject设置成要为其显示属性的对象。

　　（2）网格中显示的信息是分配对象时的属性快照。如果在运行时从代码中更改了由 SelectedObject 指定的对象的属性值，则一直要到在网格中执行了某个操作而使网格刷新时，才会显示新值。

　　（3）PropertyGrid中的属性选项卡作为按钮显示在 PropertyGrid 顶部的工具栏上，并且可以在 PropertyTabScope 中定义的范围内变化。可以使用 LargeButtons 属性公开用按钮而不是该默认值较小。大按钮为 32 x 32 像素，而不是标准的 16 x 16 像素。大小按钮和属性列出 expander 图标 (加号图标) 基于一组系统的 DPI 调整大小，当 app.config 文件包含以下项时：

</appSettings>

　　（4）PropertyGrid 控件最初并不在开发环境的工具箱中提供。可以将属性网格添加到工具箱中，以便将 PropertyGrid 拖到窗体中。您还可以通过在源代码中添加相应的代码来定义 PropertyGrid 的实例。

　　（5）默认情况下，SelectedObject 的所有公共属性将会在 PropertyGrid 中显示。您可以通过使用 BrowsableAttribute 修饰某属性并将其值设置为 false 来隐藏该属性，以使其不在 PropertyGrid 控件中显示。您可以提供具有 CategoryAttribute 的一个类别来指定在其中显示属性的类别。您可以使用 DescriptionAttribute 为在 PropertyGrid 控件底部显示的属性提供说明性文字。

　　这几段文字基本说明了PropertyGrid的用法，很简单，只要new 一个PropertyGrid对象（或者直接从工具箱中拖），设置其几个属性（大小，位置），需要显示某个对象的属性时，只需将该对象赋给PropertyGrid的SelectedObject属性即可。

　　如果对象的属性通过其他的方式（不是通过PropertyGrid）改变了，只需要调用PropertyGrid的Refresh方法，即可更新。

　　PropertyGrid中的属性选项卡作为按钮显示在 PropertyGrid 顶部的工具栏上，通过LargeButtons 属性可以设置按钮使用大图标或小图标。

　　小图标效果：

技术分享

　　大图标效果：

　　　　技术分享

2.使用方法

　　下面举个具体的例子进行说明：

　　假如现在我们要自定义一个控件，我们希望我们的控件的属性能显示在属性框中。

　　①新建Windows工程，在Form对话框中拖入一个PropertyGrid控件。

　　②添加我们的控件类，当然这个控件没什么用，只是用来举例说明:

 1 using System;
 2 using System.Collections.Generic;
 3 using System.ComponentModel;
 4 using System.Data;
 5 using System.Drawing;
 6 using System.Linq;
 7 using System.Text;
 8 using System.Windows.Forms;
 9 
10 namespace TestPropertyGrid
11 {
12     public class SimpleControl : System.Windows.Forms.Control
13     {
14         private int _prop;
15 
16         public int Prop
17         {
18             get { return _prop; }
19             set { this._prop = value; }
20         }
21         
22         
23         public SimpleControl()
24         {
25            
26         }
27     }
28 }

View Code

　　③在Form1中添加我们的控件，并将其赋给propertyGrid1.SelectedObject属性：

 1 public partial class Form1 : Form
 2     {
 3         SimpleControl _simpleControl;//自定义控件
 4         
 5         public Form1()
 6         {
 7             InitializeComponent();
 8 
 9             //通过PropertyGrid控件显示自定义控件属性
10              _simpleControl = new SimpleControl();
11             this.propertyGrid1.SelectedObject = _simpleControl; 
12         }
13    }

View Code

　　④运行程序，在属性框的最下面，可以找到一个杂项的节点，显示我们自定义控件中的属性。

　　　　技术分享

　　属性显示在杂项中，不好看，且功能不明确，这里需要设置属性的特性（Atrribute）来控制他在属性框中的展现。这里需要使用上面所说到的BrowsableAttribute， CategoryAttribute，DescriptionAttribute三个特性。使用这些特性的时候，注意要引入命名空间 System.ComponentModel。

　　　　BrowsableAttribute：所修饰的属性是否在 PropertyGrid 控件中显示。

　　　　CategoryAttribute：所修饰的属性在PropertyGrid 控件中分类（即杂项）

　　　　DescriptionAttribute：在 PropertyGrid 控件底部显示的说明性文字

　　在我们自定义控件中的属性加上这些特性：

1        [Browsable(true), Category("布局"),Description("just a test")]
2         public int Prop
3         {
4             get { return _prop; }
5             set { this._prop = value; }
6         }

View Code　

　　运行效果如下，属性出现在布局类别中，选中该项，下面会出现Description特性中描述的文字。

　　　　技术分享

3.对象集合的属性显示

　　接下来我们再定义一个自定义控件SimpleControl2，该控件和SimpleControl一样有个Prop属性，但多一个Prop2属性：

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 using System.ComponentModel;
 6 
 7 namespace TestPropertyGrid
 8 {
 9     public class SimpleControl2 : System.Windows.Forms.Control
10     {
11         private int _prop;
12         private int _prop2;
13 
14         [Browsable(true), Category("布局"), Description("just a test")]
15         public int Prop
16         {
17             get { return _prop; }
18             set { this._prop = value; }
19         }
20 
21         [Browsable(true), Category("布局"), Description("just a test")]
22         public int Prop2
23         {
24             get { return _prop2; }
25             set { this._prop2 = value; }
26         }
27 
28 
29         public SimpleControl2()
30         {
31             _prop = 1;
32         }    
33 }

View Code

　　在Form1中添加一个SimpleControl2控件和Control集合：

 1 public partial class Form1 : Form
 2 {
 3         SimpleControl _simpleControl;     //控件1
 4         SimpleControl2 _simpleControl2; //控件2
 5         Control[] _controls;                      //集合
 6         
 7         public Form1()
 8         {
 9             InitializeComponent();
10 
11             _simpleControl = new SimpleControl();
12             _simpleControl2 = new SimpleControl2();
13             _controls = new Control[] { _simpleControl, _simpleControl2 };
14 
15             this.propertyGrid1.SelectedObject = _controls; 
16         }
17 }