提供可交互的属性视图
当你在Visual C# NET中创建一个项目的时候你可能会注意到属性窗口的工具栏上有一个像闪电的按钮按下这个按钮属性窗口就会切换到事件视图这样就可以来编辑事件处理了
属性窗口的视图来自属性页（Property Tabs）因此视图使用的最主要的类是PropertyTab命名空间是SystemWindowsFormsDesign一个属性页可以和一个特别的组件设计文档关联起来或者是可以使用的静态关联和组件或文档关联起来的属性页在类上用PropertyTabAttribute特性来指定这个特性指定要创建的Tab的类型它在属性窗口上是否显示由PropertyTabAttribute的PropertyTabScope参数来指定指定为Component范围的属性页的可见性由有PropertyTabAttribute特性的组件的可见性来决定Document范围的属性页则可以在当前项目的设计中都可见他的默认值是PropertyTabScopeComponent
举一个例子来说看看FunkyButton项目FunkyButton是一个扩展了PropertyTab的UserControl而且可以让我们把控件定为不规则的多边形
图 FunkyButton
当前选择的属性页就是属性窗口从被选择的控件的属性中得到的属性页因此就允许来操纵显示属性的不同集合Events页就是像属性一样以某种方式来处理事件在这个例子中属性页就创建了表示控件顶点的属性
NET framework中的属性用PropertyDescriptor类来封装PropertyDescriptor本身是一个抽象类framework中由他派生的类提供了访问组件的开放属性的方法不过属性窗口是直接作用在PropertyDescriptor上而不是直接作用在属性上因此我们就可以写自己的PropertyDescriptor来做一些特殊的工作在这个例子里我们就有一个属性表示控件的顶点数另一个就表示每一个顶点再次注意一下我们在属性窗口上增加页并不相应的作用在其他对象上
当属性窗口向PropertyTab询问Properties的时候它就调用GetProperties方法对于我们的示例程序这个方法就像下面的一样
public override PropertyDescriptorCollection
GetProperties(ITypeDescriptorContext context object component
Attribute[] attrs)
{
// our list of props
//
ArrayList propList = new ArrayList();
// add the property for our count of vertices
//
propListAdd(new NumPointsPropertyDescriptor(this));
// add a property descriptor for each vertex
//
for (inti = ; i < ((FunkyButton)component)PointsCount; i++)
{
propListAdd(new VertexPropertyDescriptor(thisi));
}
// return the collection of PropertyDescriptors
PropertyDescriptor[] props =
(PropertyDescriptor[])propListToArray(typeof(PropertyDescriptor));
return new PropertyDescriptorCollection(props);
}
GetProperties仅仅是返回一些属性描述的集合PropertyDescriptors是相当的简单仔细查看这些代码以了解他们是怎么工作的
FunkyButton同时示例了下拉列表编辑器的实现对于每一个点我们不是简单的输入坐标的X和Y值我们会图示FunkyButton的形状而且可以用图形化的方法改变点的位置这样设置的编辑样式更加地友好
图 图形化的点向量
由于订制的PropertyTab提供了属性重载这个属性的编辑器也是很容易的只要简单地重载PropertyDescriptor的GetEditor方法然后返回订制组件的实例就可以了
public override object GetEditor(Type editorBaseType)
{
// make sure were looking for a UITypeEditor
//
if (editorBaseType == typeof(SystemDrawingDesignUITypeEditor))
{
// create and return one of our editors
//
if (editor == null)
{
editor = new PointUIEditor(ownertarget);
}
return editor;
}
return baseGetEditor(editorBaseType);
}
设计编辑器同样简单编辑器就是一个简单的UserControl所以我们就可以像设计其他的windowsForms对象一样来做
图 Designing the editor
最后当用户在属性窗口中点击下拉箭头时我们的编辑器就可以将刚才创建UI编辑器弹出来了PointUIEditor中的UITypeEditorEditValue重载后就可以实现了
public override object EditValue(
ITypeDescriptorContext context
IServiceProvider sp object value)
{
// get the editor service
IWindowsFormsEditorService edSvc =
(IWindowsFormsEditorService)spGetService(typeof(IWindowsFormsEditorService));
// create our UI
if (ui == null)
{
ui = new PointEditorControl();
}
// initialize the ui with the settings for this vertex
uiSelectedPoint = (Point)value;
uiEditorService = edSvc;
uiTarget = (FunkyButton)contextInstance;
// instruct the editor service to display the control as a
// dropdown
edSvcDropDownControl(ui);
// return the updated value;
return uiSelectedPoint;
}
我们同样可以使用它
在你自己的应用中可以拥有和IDE属性窗一样的特性把SystemWindowsFormsPropertyGrid的控件添加到IDE中的ToolBox中通过获取在ToolBox的Component标签里的PropertyGrid
PropertyGrid和其他的控件工作是一样的你可以anchor或者是Dock他改变它的色彩等下面的列表列出了PropertyGrid的一些有趣的属性
这些属性都可以在设计时设置在运行时可以操作PropertyGrid让他显示的你的对象下面是显示一个button的例子在这个例子中PorpertyGrid的帮助和toolbox都被隐藏了就像上面提到的你可以设置他自己的属性
图 隐藏了toolbar和帮助信息的PropertyGrid
结论
NET framework和Visual Studio NET给属性窗口增加了相当多的功能由于属性窗口是RAD的核心这些特性可以在保持易用性的同时有很多的扩展也因此在Visual Basic中用的很普遍就像可以在我们的程序中使用PropertyGrid我们可以把更多的时间放在如何写好程序上从而简化我们的UI工作
下面的代码是我实现的关于PointF的类型转换如果是自定义类型构造方式完全一样在重载时最关键的地方就是GetPropertys的实现不能直接返回基类的方法否则子属性的值是修改不了的必须返回TypeDescriptor的GetPropertys至于为什么请自行查阅MSDN上相关文章的介绍
#region PointF的转换类实现
/// <summary>
/// PointF的转换类实现
/// </summary>
internal sealed class PointFConverter : TypeConverter
{
/// <summary>
/// 重载TypeConverter的CanConvertFrom方法
/// </summary>
/// <param name=context></param>
/// <param name=sourceType></param>
/// 要测试的目标类型
/// <returns></returns>
public override bool CanConvertFrom(ITypeDescriptorContext context
Type sourceType)
{
if (sourceType == typeof(string)) //sourceType的类型是Type
{
return true;
}
return baseCanConvertFrom(context sourceType);
}
/// <summary>
/// 重载TypeConverter的ConvertFrom方法
/// 定义从源类型到目标类型的转换算法
/// </summary>
/// <param name=context></param>
/// <param name=culture></param>
/// 本地化参数
/// <param name=value></param>
/// 输入字串
/// <returns></returns>
public override object ConvertFrom(ITypeDescriptorContext context CultureInfo culture object value)
{
if (value is string) //value是类型实例
{
string[] v = ((string)value)Split(new char[] {});
return new PointF
