.NET组件编程(6) Component Designer

        这章主要讲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;
        }

    }

}

效果如下:




posted @ 2006-03-27 08:31  mapserver  阅读(7799)  评论(16编辑  收藏  举报