Script与Native交互基础

1 参照SDK中“plain-win”的例子，自定义一个窗口类，继承自sciter::host< window >和sciter::event_handler

class window: public sciter::host<window>
            , public sciter::event_handler
{
  HWND _hwnd;
  static LRESULT CALLBACK    wnd_proc(HWND, UINT, WPARAM, LPARAM);
  static window* ptr(HWND hwnd);
  static bool init_class();
public:
  // notification_handler traits:
  HWND      get_hwnd() const { return _hwnd; }
  HINSTANCE get_resource_instance() const{ return ghInstance; }
  window();
  bool init(); // instance
  bool is_valid() const { return _hwnd != 0; }
};

注意：
HWND get_hwnd() const { return _hwnd; }
HINSTANCE get_resource_instance() const{ return ghInstance; }
必须要实现，否则host无法获取资源

2 在窗口初始化的时候，通过sciter::attach_dom_event_handler绑定Sciter DOM事件到该窗口上

bool window::init()
{
   SetWindowLongPtr(_hwnd, GWLP_USERDATA, LONG_PTR(this));
   setup_callback();
   // // attach event_handler to the window
   sciter::attach_dom_event_handler(_hwnd, this); 
   load_file(L"res:default.htm");
   return true;
}

简化方式

SDK中已经为每个操作系统平台定义了各自的“主”函数

sciter-sdk/include/sciter-win-main.cpp - on Windows
sciter-sdk/include/sciter-osx-main.mm - on OS X
sciter-sdk/include/sciter-gtk-main.cpp - on Linux

这里我们将sciter-win-main.cpp包含到我们项目中，自定义个窗口类，继承自sciter::window

Script调用Native

在自定义窗口类中，通过类似MFC的消息映射方式来绑定事件处理函数

  BEGIN_FUNCTION_MAP
      FUNCTION_0("helloWorld", helloWorld);
      FUNCTION_2("native_sum", native_sum);       // 后面的2表示有2个参数
      FUNCTION_0("native_api", native_api);
  END_FUNCTION_MAP
  sciter::string  helloWorld() { return L"Hello u-minimal World"; }
  int native_sum(sciter::value a, sciter::value b) { return a.d + b.d; }
  sciter::value native_api() {
    sciter::value api_map;
    sciter::value api_math_map;
    std::function<int(int,int)> native_sum = [](int a, int b) { return a + b; };
    std::function<int(int,int)> native_sub = [](int a, int b) { return a - b; };
    api_math_map.set_item(sciter::value("sum"), sciter::vfunc( native_sum ));
    api_math_map.set_item(sciter::value("sub"), sciter::vfunc( native_sub ));
    api_map.set_item(sciter::value("math"), api_math_map);
    return api_map;
  }

在tiscript中这么调用

<script type="text/tiscript">
    var message = view.helloWorld();
    view.native_sum(a, b);
    view.nativeApi().math.sub(c, d);
</script>

这里的view是全局对象，代表当前运行Sciter的窗口, 他有很多自带的函数，如close(关闭), msgbox(消息框)，selectFile(文件选择框)，Update等。

在FUNCTION_MAP中定义的函数映射，可以通过view来直接调用：view.native_sum(a, b)。

另外有一种方法可以将Native写的函数包装在一起，比如native_api，view在调用的时候，直接使用view.native_api().math.xxx

sciter::value native_api()函数，返回值是一个Map类型，转换成sciter::value,结构类似下面：

return {
  math: {
    sum: {native_sum},
    sub: {native_sub},
  }
}

Native调用Script

比如在script中有这么一个方法：

<script type="text/tiscript">
    namespace Test {
        function add(n1,n2) { return n1+n2; }
    }
</script>

在Native中这么调用：

sciter::dom::element root = self->get_root();
sciter::value r;
try {
    r = root.call_function("Test.add",sciter::value(2),sciter::value(2));
} catch (sciter::script_error& err) {
    std::cerr << err.what() << std::endl;
}
// or sciter::value r = self->call_function("Test.add",sciter::value(2),sciter::value(2));
assert(r.is_int() && r.get(0) == 4);

Test是script中的命名空间
self是当前窗口sciter::host< window >对象实例