[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等。
这些函数可以在帮助文档里面查看:
简单的HTML测试代码:
<html> <head> <title>Hello Worldtitle> <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 Worldtitle> <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()函数,
请确保不是使用测试工具调用的,否则无效!", "你确定调用?",[ {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