ActiveX（二）Js 监听 ActiveX中的事件

在上一篇随笔：ActiveX（一）第一个简单的Demo 中，已经可以实现 js 单向调用 ActiveX 中的方法，在很多情况下ActiveX中的方法的执行时相对耗时、耗性能的。在这样的情况下、ActiveX的方法执行会使用异步策略，那么方法异步时，js又如何获取异步执行结果呢？方案无非两种，一种是轮训、一种是Notify。

如果是Notify，Js如何监听其事件呢？ 这将是本篇随笔接下来的重点： 

继续上一个Demo，假设，技术需求如下：当按回车时、ActiveX将密码框中的密码主动推给Js （使用Notify机制）。

在常规开发中，ActiveX的代码如下即可：

    [Guid("30A3C1B8-9A9A-417A-9E87-80D0EE827658")]
    public partial class PasswordControl : UserControl
    {
        public delegate void NotifyHandler(string pwd);

        /// <summary>
        /// 在js中监听该事件
        /// </summary>
        public event NotifyHandler OnNotify;

        public PasswordControl()
        {
            InitializeComponent();
        }

        public string GetPwd()
        {
            return this.txtPwd.Text;
        }

        private void txtPwd_KeyPress(object sender, KeyPressEventArgs e)
        {
            if ((Keys)e.KeyChar == Keys.Enter)
            {
                // 回车 触发事件
                if (this.OnNotify != null)
                {
                    this.OnNotify(this.txtPwd.Text);
                }
            }
        }
    }

我们只需要在 Js 中监听相应的事件、即可完成技术需求。

但是、经过尝试，都无法监听到ActiveX中的事件，于是 Google了一下、 找到了解决方案。

1）添加一个新接口，

2）为新接口添加一个新的GUID，（不能和 PasswordControl 的GUID 相同）

3）添加属性：    [InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]

4）添加 和 需要监听的事件 相同签名的方法。

即，形成如下所示的代码：

    [Guid("FDA0A081-3D3B-4EAB-AE01-6A40FDDA9A60")]
    [InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
    public interface IComEvents
    {
        [DispId(0x00000001)]
        void OnNotify(string pwd);
    }

5） 为PasswordControl 添加属性： [ComSourceInterfaces(typeof(IComEvents))]

即、如下所示：

    [ComSourceInterfaces(typeof(IComEvents))]
    [Guid("30A3C1B8-9A9A-417A-9E87-80D0EE827658")]
    public partial class PasswordControl : UserControl
    {
        //... 其他代码
    }    

6）Js端用如下的方式监听事件：

    <script language="Javascript" event="OnNotify(pwd)" for="activieX">
        function activieX::OnNotify(pwd) {
            console.info("密码:" + pwd);
        }
    </script>

event:指定监听的事件

for:指定监听对象

js函数名称使用 ：[监听对象]::[监听事件]的形式，注意、中间是两个冒号。

这样，Js就可以在密码框敲回车的时候、接收到ActiveX推送的密码了。 是不是很简单呢？

有两点需要注意：

1、事件所对应的delegate需自定义、不要使用系统的Action<T>

2、js函数名称使用 ：[监听对象]::[监听事件]的形式，中间是两个冒号。

测试项目源码：TestActiveX.zip

(未完待续...)