C#将C++动态库的回调函数封装成事件

  关于C#调用C++动态库的文章很多,调用动态库中回调函数的方法也不在少数。但大多数调用回调函数的方法依然保留了C++的语法特点。

  比如有一段C++的回调函数代码,为了表达它的意思,我把注释也粘贴了进来:

    /*********************************************************************************************************
   ** Function name:     epcBuzzerAsyncOn
   ** Descriptions:      本函数使蜂鸣器蜂鸣指定时间
   ** input parameters:        dwOntime    蜂鸣器持续蜂鸣的时间(ms),其中0表示一直蜂鸣
   ** output parameters:    无
   ** Returned value:          TRUE:成功;FALSE:失败
   ** Note:                    本函数以异步方式执行,不会被阻塞
   *********************************************************************************************************/

EPCBUZZERLIB_API BOOL epcBuzzerAsyncOn (DWORD dwOntime);

  /********************************************************************************************************* ** Function name: epcBuzzerSetCallBackFunc ** Descriptions: 设置回调函数指针,当异步的蜂鸣器操作任务完成后,会调用该回调函数通知用户程序。 ** input parameters: lpfnNotify 回调函数指针,如果是NULL,则表示不需要通知用户程序。函数类 ** 型为void (*lpfnNotify)(BOOL bResult),bResult为执行结果, ** TRUE表示执行成功,FALSE表示执行失败 ** output parameters: 无 ** Returned value: 无 *********************************************************************************************************/ EPCBUZZERLIB_API VOID epcBuzzerSetCallBackFunc( void (*lpfnNotify)(BOOL));

 

  一般的文章都会教你转换成如下代码,这些方法都属于Buzzer类:

     /// 
        /// 使蜂鸣器蜂鸣指定时间,异步执行,不会阻塞当前线程.
        /// 
        /// 蜂鸣时间(ms).
        /// true:蜂鸣成功,false:蜂鸣失败
        [System.Runtime.InteropServices.DllImport("Lib\\epcBuzzerLib.dll", SetLastError = true)]
        private static extern bool epcBuzzerAsyncOn(int onTime);

     /// 
        /// 先申明一个委托,该委托定义了蜂鸣完成回调函数的指针和数据类型
        /// 
        /// if set to true [result].
        public delegate void BuzzerHandler(bool result);

        /// 
        /// 再设置蜂鸣完成回调函数.
        /// 
        /// The handler.
        [System.Runtime.InteropServices.DllImport("Lib\\epcBuzzerLib.dll", SetLastError = true)]
        private static extern void epcBuzzerSetCallBackFunc(BuzzerHandler handler);

 

  然后在主程序中如此调用:

//先定义一个满足委托类型的函数
public void BuzzerNotify(bool result)
{
   //在这里编写蜂鸣完成后你想要执行的代码...我这里根据result随便写几行。
if(result) {   MessageBox.Show("蜂鸣成功"); } else {   MessageBox.Show("蜂鸣失败"); } } //在按钮事件中调用回调函数 private void onButton_Click(object sender, EventArgs e) {   Buzzer.epcBuzzerCallBackFunc(this.BuzzerNotify);   Buzzer.epcBuzzerAsyncOn(3000); }

这样,在蜂鸣器蜂鸣3000ms之后,就会调用BuzzerNotify,并将一个bool结果传进去。然后你可以在BuzzerNotify中做你想做的事。

  虽然这样也能够解决问题,但是我总感觉很别扭,总觉得我的代码里有C++风格,这让有代码洁癖的我感觉到浑身不自在。所以,我决定重构一下这段代码,让它符合C#的风格。

  重构的思想是这样的,虽然我不太能完全理解回调函数这个东西,但是我能隐约感觉到它就是一个事件触发机制,比如上面那段代码,就可以理解为当蜂鸣完成后,就会通知BuzzerNotify,让它开始执行。只不过BuzzerNotiy是在主函数中定义的一个函数,它不能像事件那样可以注册,你所有想在蜂鸣器完成后做的工作,都必须写在这个函数里面。很明显,如此糟糕的扩展性,完全不是C#的风格。所以,我要做的,就是将BuzzerNotify变成Buzzer类的一个事件,让它可以使用+=这样的神器!

  其实做法也是蛮简单的,我把代码一贴出来大家立马就能明白了。以下是Buzzer类的代码

        /// 
        /// 申明蜂鸣完成回调函数指针和数据类型
        /// 
        /// if set to true [result].
        public delegate void BuzzerHandler(bool result);

        /// 
        /// 蜂鸣完成时触发该事件.
        /// 
        public static event BuzzerHandler BuzzingComplete;     
  
        /// 
        /// 使蜂鸣器蜂鸣指定时间,异步执行,不会阻塞当前线程.
        /// 
        /// 蜂鸣时间(ms).
        /// true:蜂鸣成功,false:蜂鸣失败
        public static bool TurnOn(int time)
        {
            Buzzer.BuzzingCompleteSetCallBack();
            return Buzzer.epcBuzzerAsyncOn(time);
        }    

        /// 
        /// 使蜂鸣器蜂鸣指定时间,异步执行,不会阻塞当前线程.
        /// 
        /// 蜂鸣时间(ms).
        /// true:蜂鸣成功,false:蜂鸣失败
        [System.Runtime.InteropServices.DllImport("Lib\\epcBuzzerLib.dll", SetLastError = true)]
        private static extern bool epcBuzzerAsyncOn(int onTime);

        /// 
        /// 定义蜂鸣完成回调函数,用来处理事件.这个方法比较关键,它相当于把之前的BuzzerNotify,只不过把它封装进Buzzer类了。
        /// 
        /// if set to true [result].
        private static void Event(bool result)
        {
            if (BuzzingComplete != null)
            {
                BuzzingComplete(result);
            }
        }


        /// 
        /// 蜂鸣完成回调函数.
        /// 
        private static void BuzzingCompleteSetCallBack()
        {
            Buzzer.epcBuzzerSetCallBackFunc(Event);
        }

        /// 
        /// 设置蜂鸣完成回调函数.
        /// 
        /// The handler.
        [System.Runtime.InteropServices.DllImport("Lib\\epcBuzzerLib.dll", SetLastError = true)]
        private static extern void epcBuzzerSetCallBackFunc(BuzzerHandler handler);

虽然多了很多代码,但为了面向对象,这绝对是值得的!
在主函数中可以如此调用:

private void FirstThing(bool result)
{
    MessageBox.Show("Do my first thing");
}

private void SecondThing(bool result)
{
    MessageBox.Show("Do my second thing");
}

private void onButton_Click(object sender, EventArgs e)
{
     Buzzer.BuzzingComplete += this.FirstThing;
     Buzzer.BuzzingComplete += this.SecondThing;
     Buzzer.TurnOn(3000);
}

如此一来,主程序中的代码看上去就舒服多了。值得一提的是,如果你连续点几次这个OKButton的话,这两个方法会被重复注册。

转载于:https://www.cnblogs.com/Beyond-LCF/p/4467235.html

你可能感兴趣的:(c/c++,c#,runtime)