事件,委托,总是看起来有点绕,不过本文不介绍这些,只说说如何为自定义控件添加自定义事件。

本文所说的自定义控件,非继承其他现有Microsoft控件或者组合控件,而是完全继承UserControl的东西。

既然不是继承自其他现有控件或者控件组合,在特定需求下,有添加自定义事件的可能性,或者对继承自UserControl而得到的事件进行些许扩展,以期以简便的方式得到更丰富的信息等等。

下面简单介绍2个例子,有用之人作为参考,大拿级别的,ignore吧。

例1. 添加完全自定义事件。

需求:

假设客户端(指添加了自定义控件的窗体等等)想知道用户是否在控件上按下的Shift键(当然,可以通过KeyPress之类的事件来判断,没必要再自己整个事件,例子只是个例子),控件作者想通过一个特殊的方式来进行判断,这就可以选择自定义事件。

好吧,起个名字,叫Custom,需要客户端在触发Custom时得到一个布尔属性Flag来判断用户是否按下Shift。

按部就班:

(1)创建事件

        // 创建事件

        public event CustomEventHandler Custom;

有问题,CustomEventHandler是什么,当然,这里需要一个委托,于是还是搞定这个委托

(2)定义委托

    // 定义委托

    public delegate void CustomEventHandler(object sender, CustomEventArgs e);

CustomEventHandler搞定了,又有新问题:CustomEventArgs是啥,其实需要CustomEventArgs来获得你需要的数据,CustomEventHandler,于是还要定义个CustomEventArgs(这个东西必须继承自System.EventArgs),在CustomEventArgs里面定义需要的数据属性:Flag

(3)定义EventArgs

    // 自定义EventArgs,并添加自定义属性【Flag】

    public sealed class CustomEventArgs : EventArgs

    {

        private bool testFlag;

        public CustomEventArgs(bool testFlag)

        {

            this.testFlag = testFlag;

        }

        public bool Flag

        {

            get { return testFlag; }

        }

    }

有了CustomEventArgs,以后在触发事件之后便可以从e.Flag中得到数据。

事件定义完了,这下看看效果先:

自定义控件添加事件_控件

能看到在属性窗口中已经能见到Custom事件

可是Custom到底是怎么执行和在控件内部触发的呢,想破头~

(4)执行事件的代码

需要一个OnCustom来完成任务

        // 执行事件

        protected virtual void OnCustom(CustomEventArgs e)

        {

            if (Custom != null)

            {

                Custom(this, e);

            }

        }

 

Custom(this, e);

来完成调动客户端的任务,现在问题的关键就在于在合适的地方执行一下OnCustom就可以了,在何处执行,全看你需要的数据在什么地方能后取得或者发生变化,本例简单点,就在控件本身的KeyDown事件里面好了:

(5)何处执行OnCustom

        // 触发事件处

        private void MyControl_KeyDown(object sender, KeyEventArgs e)

        {

            // 此处省略无关代码。。。

 

            // 客户端按下Shift键与否

            bool testFlag = e.Shift;

            CustomEventArgs eArgs = new CustomEventArgs(testFlag);

            // 触发事件

            OnCustom(eArgs);

 

            // 此处省略无关代码。。。

        }

至此算基本完成,看下最终效果:

自定义控件添加事件_控件_02

在测试窗体上使用自定义控件的Custom事件

 

例2.对原有事件进行一定扩展,并覆盖原事件

需求:

想在KeyPress中再多获得一些数据,起个名字:KeyAscii,但是KeyPress中没有这个,那就自定义一个CustomKeyPress,不用KeyPress,并使其在客户端隐藏

隐藏的办法:

        // 屏蔽KeyPress事件使其在客户端不可见

        [Browsable(false)]

        public new event KeyPressEventHandler KeyPress;

以后跟例一差不多了,

创建事件,委托:

        // 创建事件CustomKeyPress替代KeyPress

        public event CustomKeyPressEventHandler CustomKeyPress;

    // 定义委托

    public delegate void CustomKeyPressEventHandler(object sender, CustomKeyPressEventArgs e);

CustomKeyPressEventArgs要继承自KeyPressEventArgs,而System.Windows.Forms.KeyPressEventArgs其实继承自System.EventArgs

   // 自定义KeyPressEventArgs,并添加自定义属性【KeyAscii】

    public sealed class CustomKeyPressEventArgs : KeyPressEventArgs

    {

        private Int32 keyAscii;

        public CustomKeyPressEventArgs(Int32 keyAscii) : base((char)keyAscii)

        {

            this.keyAscii = keyAscii;

        }

        public Int32 KeyAscii

        {

            get { return keyAscii; }

        }

    }

触发事件处:

        // 触发事件处

        protected override void OnKeyPress(KeyPressEventArgs e)

        {

            if (CustomKeyPress != null)

            {

                CustomKeyPressEventArgs eArgs = new CustomKeyPressEventArgs(e.KeyChar);

                CustomKeyPress(this, eArgs);

            }

            base.OnKeyPress(e);

        }

需要特别注意的是,KeyPress被隐藏之后,控件本身的KeyPress事件也将不能被触发

 

OK....

更多参考....

 Demo下载

更新:

关于隐藏事件,其实有别的办法,

即添加一个Class,继承ControlDesigner,重写中的相关方法,然后在控件上面Attribute一下:[DesignerAttribute(typeof(自己添加的Class))]

注意,之前所谓的“在客户端隐藏”,有点用词不当,这其实是指在VS IDE的属性窗口中不可见,并不意味着无法在客户端访问,其实使用代码还是可以的。