PropertyGrid控件由浅入深(二):基础用法
目录
- PropertyGrid控件由浅入深(一):文章大纲
- PropertyGrid控件由浅入深(二):基础用法
控件的外观构成
控件的外观构成如下图所示:
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调试状态这个值的属性
其中包含了两个重要的属性:OldValue和ChangeItem。而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 };
我们看看最终的结果:
如何更改属性的展示
在使用propertyGrid1.SelectedObject = stu;
绑定属性到对象之后,我们发现,属性的名称总是英文的名称,描述也是不按我们的意思来,那么怎么修改呢?
PropertyGrid采用Attribute
特性来控制属性的显示,除了属性名称、描述之后,还能控制属性是否只读、属性是否显示等等。具体可用的特性枚举如下:
DescriptionAttribute - 设置显示在属性下方说明帮助窗格中的属性文本。这是一种为活动属性(即具有焦点的属性)提供帮助文本的有效方法。
CategoryAttribute - 设置属性在网格中所属的类别。当您需要将属性按类别名称分组时,此特性非常有用。如果没有为属性指定类别,该属性将被分配给杂项 类别。
BrowsableAttribute – 表示是否在网格中显示属性。此特性可用于在网格中隐藏属性。默认情况下,公共属性始终显示在网格中。
ReadOnlyAttribute – 表示属性是否为只读。此特性可用于禁止在网格中编辑属性。默认情况下,带有 get 和 set 访问函数的公共属性在网格中是可以编辑的。
DefaultValueAttribute – 表示属性的默认值。如果希望为属性提供默认值,然后确定该属性值是否与默认值相同,则可使用此特性。
注意,此属性仅用于序列化以及控件本身使用,并不实际对属性进行默认值赋值。也就是,即使你设置了DefaultValue,在实际运行中,如果你没有在构造函数或者其他任何地方赋值,则系统不会对该属性赋值。如果你希望真正的给个默认值,则需要在构造函数中进行默认值的赋值。[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; }
}
参考文章:
- .Net DefaultValueAttribute on Properties
- DefaultValue not working as expected when used with Custom Type Convertor
- C# PropertyGrid控件应用心得
PropertyGrid控件由浅入深(二):基础用法的更多相关文章
- PropertyGrid控件由浅入深(一):文章大纲
Winform中PropertyGrid控件是一个非常好用的对象属性编辑工具,对于Key-Value形式的数据的处理也是非常的好用. 因为Property控件设计良好,在很小的空间内可以展示很多的内容 ...
- C# 如何定义让PropertyGrid控件显示[...]按钮,并且点击后以下拉框形式显示自定义控件编辑属性值
关于PropertyGrid控件的详细用法请参考文献: 1.C# PropertyGrid控件应用心得 2.C#自定义PropertyGrid属性 首先定义一个要在下拉框显示的控件: using Sy ...
- C# PropertyGrid控件应用心得 【转】
源文 : http://blog.csdn.net/luyifeiniu/article/details/5426960 c#stringattributesobjectmicrosoftclass ...
- WinForm小白的WPF初试一:从PropertyGrid控件,输出内容到Word(上)
学WinForm也就半年,然后转到WPF,还在熟悉中.最近拿到一个任务:从PropertyGrid控件,输出内容到Word.难点有: 一.PropertyGrid控件是WinForm控件,在WPF中并 ...
- WinForm窗体PropertyGrid控件的使用
使用过 Microsoft Visual Basic 或 Microsoft Visual Studio .NET的朋友,一定使用过属性浏览器来浏览.查看或编辑一个或多个对象的属性..NET 框架 P ...
- C# PropertyGrid控件应用心得
何处使用 PropertyGrid 控件 在应用程序中的很多地方,您都可以使用户与 PropertyGrid 进行交互,从而获得更丰富的编辑体验.例如,某个应用程序包含多个用户可以设置的“设置”或选项 ...
- 重新想象 Windows 8 Store Apps (9) - 控件之 ScrollViewer 基础
原文:重新想象 Windows 8 Store Apps (9) - 控件之 ScrollViewer 基础 [源码下载] 重新想象 Windows 8 Store Apps (9) - 控件之 Sc ...
- 背水一战 Windows 10 (46) - 控件(ScrollViewer 基础): ScrollViewer, ScrollBar, ScrollContentPresenter
[源码下载] 背水一战 Windows 10 (46) - 控件(ScrollViewer 基础): ScrollViewer, ScrollBar, ScrollContentPresenter 作 ...
- Android控件RecyclerView的基本用法
Android控件RecyclerView的基本用法 转 https://www.jianshu.com/p/e71a4b73098f github: https://github.com/Cym ...
随机推荐
- Javascript 的执行环境(execution context)和作用域(scope)及垃圾回收
执行环境有全局执行环境和函数执行环境之分,每次进入一个新执行环境,都会创建一个搜索变量和函数的作用域链.函数的局部环境不仅有权访问函数作用于中的变量,而且可以访问其外部环境,直到全局环境.全局执行环境 ...
- .NET Core系列 : 2 、project.json 这葫芦里卖的什么药
.NET Core系列 : 1..NET Core 环境搭建和命令行CLI入门 介绍了.NET Core环境,本文介绍.NET Core中最重要的一个配置文件project.json的相关内容.我们可 ...
- Java多线程基础——对象及变量并发访问
在开发多线程程序时,如果每个多线程处理的事情都不一样,每个线程都互不相关,这样开发的过程就非常轻松.但是很多时候,多线程程序是需要同时访问同一个对象,或者变量的.这样,一个对象同时被多个线程访问,会出 ...
- MySQL数据库和InnoDB存储引擎文件
参数文件 当MySQL示例启动时,数据库会先去读一个配置参数文件,用来寻找数据库的各种文件所在位置以及指定某些初始化参数,这些参数通常定义了某种内存结构有多大等.在默认情况下,MySQL实例会按照一定 ...
- [C#][算法] 用菜鸟的思维学习算法 -- 马桶排序、冒泡排序和快速排序
用菜鸟的思维学习算法 -- 马桶排序.冒泡排序和快速排序 [博主]反骨仔 [来源]http://www.cnblogs.com/liqingwen/p/4994261.html 目录 马桶排序(令人 ...
- JavaScript自定义媒体播放器
使用<audio>和<video>元素的play()和pause()方法,可以手工控制媒体文件的播放.组合使用属性.事件和这两个方法,很容易创建一个自定义的媒体播放器,如下面的 ...
- JavaScript模仿块级作用域
avaScript 没有块级作用域的概念.这意味着在块语句中定义的变量,实际上是在包含函数中而非语句中创建的,来看下面的例子: function outputNumbers(count){ for ( ...
- 一个诡异的COOKIE问题
今天下午,发现本地的测试环境突然跑不动了,thinkphp直接跑到异常页面,按照正常的排错思路,直接看thinkphp的log 有一条 [ error ] [2]setcookie() expects ...
- 微软发布VSBT,无需安装Visual Studio即可实现项目编译
安装了Visual Studio的那些使用微软平台的开发者通常能够非常容易地操作自己的项目:打开解决方案,修改内容,设置好所有必须的文件以及配置后编译项目.但是在构建服务器或者持续交付系统等没有安装V ...
- UVA-146 ID Codes
It is 2084 and the year of Big Brother has finally arrived, albeit a century late. In order to exerc ...