.NET组件编程（6） Component Designer

.NET组件编程（6） Component Designer2011-09-26 博客园 mapserver这章主要讲Component的Designer，Designer顾名思义就是为Component设计时服务的，Designer可以在设计时修改组件的行为，还可以提供它自己的服务和行为。

在.net里要为Control或者Component定制Designer，只要从IDesigner继承下来即可，但是在.net里ms 已经帮我们做了两个从IDesigner继承下来的基类，ComponentDesigner和ControlDesigner， ComponentDesigner是为Component而设计的，ControlDesigner是为Control而设计的，所以我们可以直接从ComponentDesigner继承。

Designer可以提供右键快捷菜单上的菜单命令，我们可以通过实现ComponentDesigner 谓词（Verbs）属性来定义 get 访问器，该访问器返回的 DesignerVerbCollection 中包含用于生成菜单命令的 DesignerVerb 对象。

同时我们对组件被双击时定制默认操作，在Component Designer实现 DoDefaultAction 方法即可。

示例代码如下：

using System;
using System.Collections.Generic;
using System.Text;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Windows.Forms;
using System.Windows.Forms.Design;

namespace ClassLibrary1
{
    [DefaultEvent（"CustomerLogin"）]
    [Designer（typeof（Class1Designer）, typeof（IDesigner））, Editor（typeof（Class1Editor）, typeof（ComponentEditor））]
    public class Customer : Component
    {
        private string _parentComponentName;
        private int _age;
        private string _address;

        public delegate void CustomerLoginEventHandler（object sender, CustomerLoginEventArgs e）;
        public delegate void CustomerLogoutEventHandler（object sender, CustomerLogoutEventArgs e）;

        public string ParentComponentName
        {
            get { return _parentComponentName; }
            set { _parentComponentName = value; }
        }
        
        public int Age
        {
            get { return _age; }
            set { _age = value; }
        }

        public string Address
        {
            get { return _address; }
            set { _address = value; }
        }

        public sealed class CustomerLoginEventArgs : EventArgs { }
        public sealed class CustomerLogoutEventArgs : EventArgs { }

        public event CustomerLoginEventHandler CustomerLogin
        {
            add { }
            remove { }
        }

        public event CustomerLogoutEventHandler CustomerLogout
        {
            add { }
            remove { }
        }
    }

    public class Class1Designer : ComponentDesigner
    {      
        public Class1Designer（） : base（）
        {
            // 添加一个谓词。
            // 添加"Click Me"到右键菜单和智能标记中。
            DesignerVerb verb = new DesignerVerb（"Click Me", new EventHandler （OnChoseMe））;
            this.Verbs.Add（verb）;
        }

        private void OnChoseMe（object sender, EventArgs e）
        {
            MessageBox.Show（"You clicked."）;
        }

        // 1、可以设计Component的默认事件创建方法签名，并将用户的光标定位到该位置。 
        // 2、也可以为Component添加双击时要进行的操作。
        public override void DoDefaultAction（）
        {
            MessageBox.Show（" You double clicked."）;
        }

        // 从工具箱上拖放一个Component时，执行此方法。
        public override void InitializeNewComponent（System.Collections.IDictionary defaultValues）
        {
            /**//*
             在创建一个新的Component时，把Parent Component的名称写到ParentName属 性中去。
             */
            // 因为是在Design Time，所以ParentComponent的Site是存在的。
            string parentName = （（Component） this.ParentComponent）.Site.Name;

            （（Customer）（this.Component））.ParentComponentName = parentName;

            /**//*
             对Component设置默认属性。
             */
            （（Customer）（this.Component））.Age = 18;
        }
        // InitializeExistingComponent、InitializeNonDefault请大家自己研究。

        // 可以对Component的属性进行操作，如移出、添加。
        protected override void PostFilterProperties（System.Collections.IDictionary properties）
        {
            // 提供有关组件属性 （Attribute） 的信息，如组件的属性 （Attribute）、属 性 （Property） 和事件。
            // 删除Address属性。
            properties.Remove（"Address"）;
        }
        // PostFilterAttributes、PostFilterEvents、PreFilterAttributes、 PreFilterEvents、PreFilterProperties请大家自己研究。

        /**//*
         对Component设置默认属性（过时，保持向下兼容），现在改为 InitializeNewComponent中进行初始化。
        */
        public override void OnSetComponentDefaults（）
        {
            base.OnSetComponentDefaults（）;
            （（Customer）（this.Component））.Age = 18;
        }
    }

    public class ClassDocumentDisigner : ComponentDocumentDesigner
    {

    }

    public class Class1Editor : ComponentEditor
    {
        public override bool EditComponent（ITypeDescriptorContext context, object component）
        {
            return true;
        }
    }
}