[Sciter系列] MFC下的Sciter–3.Sciter脚本与底层交互

时间：2022-03-12 00:06:08

[Sciter系列] MFC下的Sciter–3.Sciter脚本与底层交互，脚本调用底层自定义的方法函数。

本系列文章的目的就是一步步构建出一个功能可用，接口基本完善的基于MFC框架的SciterFrame程序，以此作为以后程序的基础。其中，文章中按照如下逻辑编排（解决如下问题）：

1、使用什么环境

2、完成什么功能

3、如何完成

1、工程环境： VS2010 + Sciter-SDK + Win7

建议：HTML页面还使用ANSI编码，UTF-8此时不建议使用。

2、本文完成的功能：HTML页面添加自定义函数调用，在底层将此函数实现，同时演示部分自带函数的使用。

3、具体步骤如下：

一、TS调用自带函数的演示：（即不需要自己编写和实现对应的函数，引擎自带）

TS脚本自身有很多自带的函数，如msgbox(消息框)，selectFile(文件选择框)，Update等。

这些函数可以在帮助文档里面查看：

[Sciter系列] MFC下的Sciter–3.Sciter脚本与底层交互

简单的HTML测试代码：

<html>

<head>

    <title>Hello World</title>

    <style>

        .test{

            background-color: black;

            color: white;

        }

    </style>

    <script type="text/tiscript">

        $(#btnExit).onClick = function () {

            stdout.println("退出");

//            view.close();

            return true;

        }

        $(#btnUpdate).onClick = function () {

            stdout.println("刷新");

            view.update();

            return true;

        }

        $(#btnLoad).onClick = function () {

            stdout.println("加载");

            var fn = view.selectFile(#open,"HTML Files (*.htm,*.html)|*.HTM;*.HTML|All Files (*.*)|*.*" , "html" );

            if( fn ) view.load(fn);

            return true;

        }

    </script>

</head>

<body bgcolor="#00AAAA" >

    <h1>自带函数测试</h1>

    <input #btnExit type="button" value="退出"/>

    <input #btnUpdate type="button" value="刷新"/>

    <input #btnLoad type="button" value="加载"/>

</body>

</html>

这个代码在Sciter.exe中就可以测试了。

二、设置自定义函数，并且调用对应的函数

我们在之前的HTML代码中添加自定义函数调用部分：

<html>

<head>

    <title>Hello World</title>

    <style>

        .test{

            background-color: black;

            color: white;

        }

    </style>

    <script type="text/tiscript">

        $(#btnExit).onClick = function () {

            stdout.println("退出");

//            view.close();

            return true;

        }

        $(#btnUpdate).onClick = function () {

            stdout.println("刷新");

            view.update();

            return true;

        }

        $(#btnLoad).onClick = function () {

            stdout.println("加载");

            var fn = view.selectFile(#open,"HTML Files (*.htm,*.html)|*.HTM;*.HTML|All Files (*.*)|*.*" , "html" );

            if( fn ) view.load(fn);

            return true;

        }

        // 调用我们程序自定义方法

        $(#btnCall).onClick = function () {

            stdout.println("调用自定义函数");

            var ret = view.msgbox(#information, "这个函数将调用底层编写的函数addsome()函数,<br/><br/>请确保不是使用测试工具调用的，否则无效！",

             "你确定调用?",[ {id:#yes, text:"确定"}, {id:#no, text:"取消"} ] );

                if( ret == #yes )

                {

                    stdout.println("确定");

                    // addsome()是自定义函数，一定要以view.xxxx(xx)方式调用

                    ret = view.addsome(3,2);

                    view.msgbox(#information,ret);

                }else{

                    stdout.println("取消");

                }

            return true;

        }

    </script>

</head>

<body bgcolor="#00AAAA" >

    <h1 .test>Hello World!</h1>

    <h2 #test1>你好啊</h2>

    <input #btnExit type="button" value="退出"/>

    <input #btnUpdate type="button" value="刷新"/>

    <input #btnLoad type="button" value="加载"/>

    <br/><br/><br/>

    <input #btnCall type="button" value="调用底层定义的函数"/>

</body>

</html>

当然，这个自定义函数现在还没有实现，并且如果在Sciter.exe中在弹出的对话框中选择“确定”也不会有下面的那个消息框弹出，因为TS脚本找不到这样一个函数用来调用，通过调试工具查看就会看到报错信息。

下面我们来进行最重要的工作，用VC++实现addsome函数：

首先，我们要明白函数调用的机理：

当TS脚本准备调用一个函数时，他肯定会先查找自身是否拥有这个函数，如果没有就会查找底层是否注册了这个函数，找到后就按照规定的规则调用它，将返回值返回到TS中，完成整个调用过程。

然后，我们通过C++来实现它：

想要完成这个过程，我们需要确保几个问题：

1、我们的程序如何让TS脚本得知实现的接口？

答：首先，我们的窗口类要继承于sciter::event_handle，这个需要头文件 #include "include/sciter-x-host-callback.h" 的支持，在窗口被加载后需要主动注册我们的窗口到TS引擎中，即调用 sciter::attach_dom_event_handler(this->m_hWnd,this); 方法，这样TS脚本就知道可以在我们的窗口中找到对应的函数。但是TS作为一种解释性的脚本语言，不可能直接调用C++的方法，所以我们还需要在做一步工作：

SDK作者早已考虑了这些问题，它使用了类似MFC的消息映射机制，如下所示：

//消息映射的函数

    json::value addsome(json::value a,json::value b); // 测试的函数

    //Sciter的TiScript消息映射

    BEGIN_FUNCTION_MAP

        FUNCTION_2("addsome", addsome) // 后面的2表示有2个参数

    END_FUNCTION_MAP

这样，当TS脚本调用addsome()函数时，通过窗口类通知给消息映射，然后消息映射调用VC++实现的addsome方法，实现自定义函数的调用。

虽然似乎这个问题已经解决了，因为函数已经可以被调用了，但是问题永远不像想想的那么简单。

2、如何处理被调函数的参数及返回值？

答：这个涉及到json类的使用，需要使用者自行摸索。我给出一个样例：

json::value CHelloWorldDlg::addsome( json::value a,json::value b )

{

    int aa = int(a.d) + int(b.d);  // xx.d 返回的是int64的整数，可以作为数据类型转换使用

    return json::value(aa);   // 返回求和后的结果

}

 

如上所述，自定义函数的声明调用都完成了，至于多线程、资源内置等内容我们在后面讨论。

补充：

相信很多人都想在自己的程序中使用到像Sciter.exe中的调试工具，如何将这个工具添加到自己的程序中去呢？其实很简单！

答：在WindowProc中拦截F12按键按下的消息，使用sciter::inspect()调用即可。需要特别注意的是一定要将sdk中的 inspector32/64.dll 拷贝到程序运行目录下，否则没效果。使用时按下F12键就可以了。

if (message == WM_KEYDOWN && wParam == VK_F12)

    {

        sciter::inspect(this->m_hWnd);

        return 0;

    }

---------------

本节源代码下载：

http://pan.baidu.com/s/17VeWm

 

博客：

CSDN：http://blog.csdn.net/bbdxf

cnBlogs: http://www.cnblogs.com/bbdxf

相关文章