文档手册

SetOption

2024-07-11 00:59:19

在 Sciter 开发中,SetOption 函数用于设置运行时选项,这些选项通过 Sciter_RT_OPTIONS 枚举值来指定。以下是每个配置项的详细说明:

  1. SCITER_SMOOTH_SCROLL 

    • 启用或禁用平滑滚动。

    • value:TRUE - 启用(默认)

    • value:FALSE - 禁用

  2. SCITER_CONNECTION_TIMEOUT  

    • HTTP 客户端的连接超时设置。

    • value - 毫秒数

  3. SCITER_HTTPS_ERROR 

    • HTTPS 错误处理策略。

    • value:0 - 丢弃连接

    • value:1 - 使用内置对话框

    • value:2 - 静默接受连接

  4. SCITER_FONT_SMOOTHING 

    • 字体平滑设置。

    • value:0 - 系统默认

    • value:1 - 不平滑

    • value:2 - 标准平滑

    • value:3 - ClearType 平滑

  5. SCITER_TRANSPARENT_WINDOW 

    • Windows Aero 支持,设置窗口透明背景。

    • value:0 - 正常绘制

    • value:1 - 调用 DwmExtendFrameIntoClientArea()DwmEnableBlurBehindWindow() 后,窗口具有透明背景

  6. SCITER_SET_GPU_BLACKLIST  

    • 设置 GPU 黑名单。

    • hWnd = NULL

    • value - LPCBYTE,JSON 格式的 GPU 黑名单

  7. SCITER_SET_SCRIPT_RUNTIME_FEATURES 

    • 设置脚本运行时功能。

    • value - SCRIPT_RUNTIME_FEATURES 标志的组合


  8. SCITER_SET_GFX_LAYER 

    • 设置图形层。

    • hWnd = NULL

    • value - GFX_LAYER

  9. SCITER_SET_DEBUG_MODE  

    • 设置调试模式。

    • hWnd

    • value:TRUE - 启用

    • value:FALSE - 禁用

  10. SCITER_SET_UX_THEMING 

    • 设置用户界面主题,使其在所有平台上统一。

    • hWnd = NULL

    • value:TRUE - 启用 "unisex" 主题

    • value:FALSE - 禁用

  11. SCITER_ALPHA_WINDOW  

    • 设置窗口使用每像素透明度(例如 WS_EX_LAYERED/UpdateLayeredWindow() 窗口)。

    • hWnd

    • value:TRUE - 启用

    • value:FALSE - 禁用

  12. SCITER_SET_INIT_SCRIPT 

    • 设置初始化脚本,该脚本会在任何其他脚本执行之前加载到每个视图中。

    • hWnd - N/A

    • value - UTF-8 编码的脚本源代码字符串

  13. SCITER_SET_MAIN_WINDOW  

    • 设置主窗口,关闭主窗口时销毁所有依赖窗口。

    • hWnd

    • value:TRUE - 设置为主窗口

    • value:FALSE - 不设置为主窗口

  14. SCITER_SET_MAX_HTTP_DATA_LENGTH  

    • 设置 HTTP 请求的最大数据长度(以兆字节为单位)。

    • hWnd - N/A

    • value - 以字节为单位的最大请求长度(1024*1024 字节)

这些选项允许开发人员在运行时配置 Sciter 引擎的各种行为和特性。