none
wpf控件设计时支持(1) RRS feed

  • 常规讨论

  • 本篇源码下载

    1.属性元数据

    image

    在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));
       
    }

    效果如下:

    image

    2.属性元数据集合

     

    wpf的设计时允许我们将这些元数据与控件属性分离出来.下面我们来实现一个简单的功能

    2.1新建一个设计时支持的单独项目

    image

    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());
        }
    }
    2009年5月31日 1:59