wpf控件设计时支持

Posted 2021-01-18 lonelyxmas

原文:wpf控件设计时支持(1)

   这部分内容几乎是大家忽略的内容,我想还是来介绍一下.

本篇源码下载

1.属性元数据

在vs IDE中,在asp.net,winfrom等开发环境下,右侧的PropertyGrid属性面板,会对属性进行分类,这有利于了解控件属性的用途.

若你之前在.net平台下做过控件开发,你应该知道这些功能是通过属性元数据实现的,比如使用Category元数据,把Content属性分到Content类别下.

[Category("Content")]
public object Content { get; set; }

 

这种方法在开发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());
    }
}

 

是不是感觉很无聊，为了这么个东西还要去研究:),觉得的有用的就看一下吧,这篇就写这么多,写完就差不多可以放假回家了.