原文: wpf控件设计时支持(1)
这部分内容几乎是大家忽略的内容,我想还是来介绍一下.
本篇
源码下载1.属性元数据
在vs IDE中,在asp.net,winfrom等开发环境下,右侧的PropertyGrid属性面板,会对属性进行分类,这有利于了解控件属性的用途.
若你之前在.net平台下做过控件开发,你应该知道这些功能是通过属性元数据实现的,比如使用Category元数据,把Content属性分到Content类别下.
[Category("Content")]
public object Content { get; set; }
http://11011.net/software/vspaste 这种方法在开发wpf自定义控件依然可用.我们以名为DesginCustomControl的自定义控件为例子.因为是wpf控件,所以属性变更为依赖项属性.
public class DesginCustomControl : ContentControl
{
[Category("Content")]
public string Content
{
get { return (string)GetValue(ContentProperty); }
set { SetValue(ContentProperty, value); }
}
public static readonly DependencyProperty ContentProperty =
DependencyProperty.Register("Content", typeof(string), typeof(DesginCustomControl), new UIPropertyMetadata(String.Empty));
}
效果如下:
2.属性元数据集合
wpf的设计时允许我们将这些元数据与控件属性分离出来.下面我们来实现一个简单的功能
2.1新建一个设计时支持的单独项目
WPF.Controls是控件项目,WPF.Controls.VisualStudio.Design是控件设计时项目
注意:
(1)程序集命名约定
设计时的程序集是有命名约定的,这样才可以受到VisualStudio的支持.如控件程序集是WPF.Controls,那么设计时程序集则是
控件程序集的名字+VisualStudio.Design
(2)设计时程序集编译位置
设计时程序集必须与控件存放在同个目录下才能工作,引用控件的项目无需引用设计时程序集
假设WPF.Controls的编译目录没有做变更的话,那么WPF.Controls.VisualStudio.Design这个项目编译好后是存在在WPF.Controls的bin目录下面的.
(3)引用Microsoft.Windows.Design程序集
Microsoft.Windows.Design是wpf设计时支持的基础,所以要引用这个程序集
2.2注册属性的元数据集合
实现一个名为IRegisterMetadata的接口。来看一下代码
public class WPFControlsCommonMetadata : IRegisterMetadata
{
public void Register()
{
AttributeTableBuilder MainBuilder = new AttributeTableBuilder();
MainBuilder.AddCustomAttributes(typeof(DesginCustomControl),DesginCustomControl.ContentProperty,new Attribute[]{
new CategoryAttribute("Content")});
MetadataStore.AddAttributeTable(MainBuilder.CreateTable());
}
}
AttributeTableBuilder是属性元数据表,msdn是解释属性表.AttributeTableBuilder有多个AddCustomAttributes重载方法.可以将元数据附加到属性上.比如上面代码给DesginCustomControl的Content属性添加了一个CategoryAttribute元数据.添加完毕以后再通过
MetadataStore的AddAttributeTable方法添加属性元数据表.MetadataStore称之为元数据存储区.
以上代码的实现与在控件上直接挂元数据标签效果是一样.有什么不同点呢?
若我们为asp.net的内置控件扩展设计时的话,则必须继承该控件.这里便不会有这个问题,两者是完全分离的.
2.3延迟添加属性元数据
上面的示例,直接在MainBuilder类中为控件添加元数据,当为比较多的控件添加元数据时,同时加载会出现性能问题,所以MainBuilder还提供了AddCallback方法,当需要时,才会为控件添加元数据.现以上示例代码变更如下
public class WPFControlsCommonMetadata : IRegisterMetadata
{
public void Register()
{
AttributeTableBuilder MainBuilder = new AttributeTableBuilder();
MainBuilder.AddCallback(
typeof(DesginCustomControl),
delegate(AttributeCallbackBuilder builder)
{
builder.AddCustomAttributes(DesginCustomControl.ContentProperty, new Attribute[]{
new CategoryAttribute("Content")});
});
MetadataStore.AddAttributeTable(MainBuilder.CreateTable());
}
}
http://11011.net/software/vspaste 是不是感觉很无聊,为了这么个东西还要去研究:),觉得的有用的就看一下吧,这篇就写这么多,写完就差不多可以放假回家了.