跳到主要内容

JadeView 类

JadeView 是模块主入口，负责运行时初始化、窗口与视图管理、事件订阅、IPC、对话框、通知以及系统能力调用。

推荐使用顺序​

  1. 设置 IPC 回调
  2. 注册 IPC 通道
  3. 手动订阅特殊事件
  4. 调用 初始化(...)
  5. 进入 运行消息循环()

初始化​

初始化​

  • 初始化运行时
  • 自动订阅默认的非拦截事件

运行消息循环​

  • 启动消息循环
  • 主线程通常以此结束启动阶段

窗口与视图能力​

主要包括：

  • 创建窗口与无边框窗口
  • 导航页面与刷新页面
  • 执行脚本
  • 控制窗口标题、位置、大小、可见性、置顶、最小化、最大化
  • 控制主题、材质、背景色、内容保护与缩放

事件​

自动订阅​

初始化() 会自动订阅大部分普通事件，例如：

  • 应用就绪
  • 第二实例
  • 窗口创建、关闭、状态变化
  • 页面开始加载、完成加载、标题更新、图标更新
  • 页面消息
  • 全局热键
  • 通知事件

手动订阅​

以下事件需要显式调用 订阅事件(...)：

  • 窗口即将关闭
  • 即将导航
  • 请求新窗口
  • 下载开始
  • 文件拖入

可拦截事件​

以下事件返回 1 表示拦截，返回 0 表示放行：

  • 窗口即将关闭
  • 即将导航
  • 请求新窗口
  • 下载开始

IPC​

推荐使用对象方法回调：

  • 置IPC频道回调(...)
  • 注册IPC通道(...)

不推荐把 IPC 当普通事件处理。

对话框与通知​

同步​

  • 打开文件对话框
  • 保存文件对话框
  • 消息框
  • 错误框

异步​

  • 打开文件对话框异步
  • 保存文件对话框异步
  • 消息框异步

异步对话框推荐使用对象方法回调。

系统能力​

还包括：

  • 协议注册与注销
  • 文件关联注册与注销
  • 全局热键注册与注销
  • 路径获取
  • YAML 读写
  • 显示器信息
  • 区域设置
  • 版本信息