常量
JadeView 易语言 SDK 内置大量公开常量，统一规范传参、事件标识、状态标记，替代手写字符串与数字，提升代码可读性、降低拼写错误。下文按功能分类罗列全部公开常量，包含常量名、底层值、用途说明。
一、窗口主题常量
| 常量名 | 底层值 | 说明 |
|---|
| #主题_亮色 | "Light" | 窗口强制浅色主题 |
| #主题_暗色 | "Dark" | 窗口强制深色主题 |
| #主题_自动 | "System" | 跟随系统明暗主题自动切换 |
二、窗口背景透明材质常量
| 常量名 | 底层值 | 说明 |
|---|
| #背景材料_云母 | "mica" | Win11 Mica 云母透明效果 |
| #背景材料_云母亚色 | "micaAlt" | 适配浅色的 Mica 云母材质 |
| #背景材料_亚克力 | "acrylic" | Acrylic 亚克力模糊透明材质 |
三、标题栏样式常量
| 常量名 | 底层值 | 说明 |
|---|
| #标题栏_标准标题栏_带边框 | "normal" | 系统原生标题栏 + 窗口边框 |
| #标题栏_无标题栏_带边框 | "no-titlebar" | 隐藏原生标题栏，保留边框 |
| #标题栏_无标题栏_无边框 | "borderless" | 完全无边框无原生标题栏 |
| #标题栏_标题覆盖层 | "title-overlay" | Windows 专属，有边框、内置右上角窗口控制按钮 |
四、窗口层级常量
| 常量名 | 底层值 | 说明 |
|---|
| #层级_置顶 | "topmost" | 窗口置顶，始终显示在顶层 |
| #层级_普通层 | "normal" | 默认普通窗口层级，取消置顶 / 置底 |
| #层级_压在其它窗口下方 | "bottom" | 窗口置于所有普通窗口底部 |
| #层级_贴桌面壁纸层 | "desktop" | 贴桌面壁纸层级，适合桌面挂件 |
五、系统路径常量
| 常量名 | 底层值 | 说明 |
|---|
| #Path_home | "home" | 用户主目录 % USERPROFILE% |
| #Path_appData | "appData" | 本地应用数据目录 % LOCALAPPDATA% |
| #Path_sessionData | "sessionData" | WebView2 缓存会话目录 |
| #Path_temp | "temp" | 系统临时目录 % TEMP% |
| #Path_exe | "exe" | 当前程序 EXE 完整路径 |
| #Path_desktop | "desktop" | 用户桌面目录 |
| #Path_documents | "documents" | 文档目录 |
| #Path_downloads | "downloads" | 系统下载目录 |
| #Path_music | "music" | 音乐文件夹 |
| #Path_pictures | "pictures" | 图片文件夹 |
| #Path_videos | "videos" | 视频文件夹 |
| #Path_logs | "logs" | 程序日志目录，不存在自动创建 |
| #Path_app | "app" | EXE 所在程序根目录 |
六、托盘菜单类型常量
| 常量名 | 底层值 | 说明 |
|---|
| #托盘_普通菜单项 | "0" | 普通可点击菜单，触发托盘命令事件 |
| #托盘_子菜单项 | "1" | 可展开子菜单容器 |
| #托盘_分隔线 | "2" | 视觉分隔线，无交互 |
| #托盘_分组 | "3" | 菜单逻辑分组，支持嵌套 |
七、页面右键菜单项类型常量
| 常量名 | 底层值 | 说明 |
|---|
| #kind_命令 | "0" | 普通点击执行命令菜单 |
| #kind_分隔线 | "1" | 右键菜单分隔线 |
| #kind_复选框 | "2" | 带勾选状态菜单项 |
| #kind_单选 | "3" | 互斥单选菜单项 |
| #kind_子菜单 | "4" | 可展开子菜单 |
| #kind_原生默认菜单项 | "5" | 保留 WebView2 原生右键菜单项 |
八、Web 原生右键菜单标识常量
| 常量名 | 底层值 | 说明 |
|---|
| #原生菜单_后退 | "back" | 浏览器后退 |
| #原生菜单_前进 | "forward" | 浏览器前进 |
| #原生菜单_刷新 | "reload" | 页面刷新 |
| #原生菜单_剪切 | "cut" | 文本剪切 |
| #原生菜单_复制 | "copy" | 文本复制 |
| #原生菜单_粘贴 | "paste" | 粘贴 |
| #原生菜单_粘贴为纯文本 | "pasteAndMatchStyle" | 无格式粘贴 |
| #原生菜单_全选 | "selectAll" | 全选文本 |
| #原生菜单_撤销 | "undo" | 撤销操作 |
| #原生菜单_恢复 | "redo" | 重做操作 |
| #原生菜单_表情符号 | "emoji" | 表情面板 |
| #原生菜单_另存为 | "saveAs" | 页面另存 |
| #原生菜单_将链接另存为 | "saveLinkAs" | 链接另存 |
| #原生菜单_图片另存为 | "saveImageAs" | 图片保存 |
| #原生菜单_将媒体另存为 | "saveMediaAs" | 音视频保存 |
| #原生菜单_复制图片 | "copyImage" | 复制图片 |
| #原生菜单_复制图片地址 | "copyImageLocation" | 复制图片链接 |
| #原生菜单_复制链接地址 | "copyLinkLocation" | 复制网页链接 |
| #原生菜单_复制链接 | "copyLink" | 复制媒体链接 |
| #原生菜单_复制选中文本 | "copyLinkToHighlight" | 复制选中文字 |
| #原生菜单_在新窗口打开链接 | "openLinkInNewWindow" | 新窗口打开链接 |
| #原生菜单_检查元素 | "inspectElement" | 开发者工具 |
| #原生菜单_拼写检查 | "spellCheck" | 拼写检查子菜单 |
| #原生菜单_更多工具 | "moreTools" | 更多工具子菜单 |
| #原生菜单_共享 | "share" | 系统共享面板 |
| #原生菜单_打印 | "print" | 打印页面 |
| #原生菜单_放大图像 | "magnifyImage" | 图片放大工具 |
九、文件对话框特性开关常量
| 常量名 | 底层值 | 说明 |
|---|
| #对话框_允许选择文件 | "openFile" | 弹窗支持单选文件 |
| #对话框_允许选择文件夹 | "openDirectory" | 弹窗支持选择目录 |
| #对话框_允许选择多个_文件_文件夹 | "multiSelections" | 开启多选模式 |
| #对话框_显示隐藏文件 | "showHiddenFiles" | 显示系统隐藏文件 |
| #对话框_允许创建新文件夹 | "createDirectory" | 弹窗内可新建文件夹 |
| #对话框_将包当作目录处理 | "treatPackageAsDirectory" | 压缩包 / 资源包视为文件夹 |
十、消息对话框图标类型常量
| 常量名 | 底层值 | 说明 |
|---|
| #对话框类型_无图标 | "none" | 弹窗无图标 |
| #对话框类型_信息提示 | "info" | 信息提示弹窗 |
| #对话框类型_警告提示 | "warning" | 警告弹窗 |
| #对话框类型_错误提示 | "error" | 错误弹窗 |
| #对话框类型_询问提示 | "question" | 确认询问弹窗 |
十一、全局热键修饰键常量
| 常量名 | 底层值 | 说明 |
|---|
| #MOD_ALT | "1" | Alt 组合键 |
| #MOD_CONTROL | "2" | Ctrl 组合键 |
| #MOD_SHIFT | "4" | Shift 组合键 |
| #MOD_WIN | "8" | Windows 徽标组合键 |
十二、任务栏进度条状态常量
| 常量名 | 底层值 | 说明 |
|---|
| #状态_无进度 | "0" | 隐藏进度条 |
| #状态_正常 | "1" | 绿色正常进度 |
| #状态_暂停 | "2" | 黄色暂停进度 |
| #状态_错误 | "3" | 红色失败进度 |
| #状态_不确定 | "4" | 无限循环加载动画 |
十三、全局事件常量
| 常量名 | 底层值 | 说明 |
|---|
| #事件_应用准备就绪 | "app-ready" | 内核初始化完成，可创建窗口 |
| #事件_右键菜单 | "context-menu" | 页面右键弹出时触发 |
| #事件_程序崩溃 | "crash" | Web 渲染进程崩溃 |
| #事件_错误框对话框完成 | "dialog-error-box-completed" | 错误弹窗关闭 |
| #事件_消息框对话框完成 | "dialog-message-box-completed" | 普通提示弹窗关闭 |
| #事件_打开文件对话框完成 | "dialog-open-file-completed" | 文件选择弹窗确认 |
| #事件_保存文件对话框完成 | "dialog-save-file-completed" | 文件保存弹窗确认 |
| #事件_拖拽操作 | "drag-drop" | 文件拖拽进入窗口 |
| #事件_全局热键触发 | "global-hotkey" | 注册的全局热键按下 |
| #事件_JAPK资源包加载失败 | "japk-load-failed" | JAPK 加载校验失败 |
| #事件_JavaScript 执行结果 | "javascript-result" | 执行 JS 返回结果 |
| #事件_菜单项被点击 | "menu-item-clicked" | 自定义右键菜单点击 |
| #事件_通知操作被点击 | "notification-action" | 桌面通知按钮点击 |
| #事件_通知已关闭 | "notification-dismissed" | 桌面通知自动关闭 |
| #事件_通知显示失败 | "notification-failed" | 系统通知弹出失败 |
| #事件_通知已显示 | "notification-shown" | 桌面通知正常弹出 |
| #事件_收到前端PostMessage | "postmessage-received" | 前端 IPC 消息推送 |
| #事件_第二个实例启动 | "second-instance" | 重复打开程序 |
| #事件_系统主题变化 | "theme-changed" | Windows 明暗主题切换 |
| #事件_托盘图标事件 | "tray-event" | 托盘左键 / 右键单击 |
| #事件_托盘菜单命令 | "tray-menu-command" | 托盘菜单项点击 |
| #事件_更新窗口图标 | "update-window-icon" | 窗口图标变更回调 |
| #事件_WebView 开始加载 | "webview-did-start-loading" | 页面开始请求资源 |
| #事件_WebView 加载完成 | "webview-did-finish-load" | 页面全部渲染完毕 |
| #事件_WebView 下载完成 | "webview-download-completed" | 文件下载结束 |
| #事件_WebView 页面图标更新 | "webview-page-favicon-updated" | 页面标签图标变化 |
| #事件_WebView 页面标题更新 | "webview-page-title-updated" | 网页标题变更 |
| #事件_WebView 页面请求打开新窗口 | "webview-new-window" | 页面弹出新窗口请求 |
| #事件_所有窗口已关闭 | "window-all-closed" | 全部 Web 窗口销毁 |
| #事件_窗口失去焦点 | "window-blurred" | 窗口切换后台 |
| #事件_窗口边界变化 | "window-bounds" | 窗口坐标 / 尺寸实时变更 |
| #事件_窗口已关闭 | "window-closed" | 单个窗口关闭完成 |
| #事件_窗口创建完成 | "window-created" | 窗口渲染、句柄就绪 |
| #事件_窗口已销毁 | "window-destroyed" | 窗口资源释放完毕 |
| #事件_窗口获得焦点 | "window-focused" | 窗口切至前台 |
| #事件_窗口全屏状态变化 | "window-fullscreen" | 全屏 / 退出全屏 |
| #事件_窗口已移动 | "window-moved" | 拖拽窗口完成 |
| #事件_窗口大小改变 | "window-resized" | 缩放窗口完成 |
| #事件_窗口状态变化 | "window-state-changed" | 最小化 / 最大化切换 |
十四、时区偏移常量（单位：UTC 偏移分钟）
| 常量名 | 底层数值 | 时区说明 |
|---|
| #时区_UTC | 0 | 格林威治标准时间 UTC+0 |
| #时区_伦敦 | 0 | 英国伦敦 UTC+0 |
| #时区_里斯本 | 0 | 葡萄牙里斯本 UTC+0 |
| #时区_都柏林 | 0 | 爱尔兰都柏林 UTC+0 |
| #时区_卡萨布兰卡 | 0 | 摩洛哥卡萨布兰卡 UTC+0 |
| #时区_拉各斯 | 60 | 尼日利亚拉各斯 UTC+1 |
| #时区_阿尔及尔 | 60 | 阿尔及利亚阿尔及尔 UTC+1 |
| #时区_巴黎 | 60 | 法国巴黎 UTC+1 |
| #时区_柏林 | 60 | 德国柏林 UTC+1 |
| #时区_罗马 | 60 | 意大利罗马 UTC+1 |
| #时区_马德里 | 60 | 西班牙马德里 UTC+1 |
| #时区_阿姆斯特丹 | 60 | 荷兰阿姆斯特丹 UTC+1 |
| #时区_维也纳 | 60 | 奥地利维也纳 UTC+1 |
| #时区_华沙 | 60 | 波兰华沙 UTC+1 |
| #时区_雅典 | 120 | 希腊雅典 UTC+2 |
| #时区_基辅 | 120 | 乌克兰基辅 UTC+2 |
| #时区_赫尔辛基 | 120 | 芬兰赫尔辛基 UTC+2 |
| #时区_布加勒斯特 | 120 | 罗马尼亚布加勒斯特 UTC+2 |
| #时区_开罗 | 120 | 埃及开罗 UTC+2 |
| #时区_约翰内斯堡 | 120 | 南非约翰内斯堡 UTC+2 |
| #时区_的黎波里 | 120 | 利比亚的黎波里 UTC+2 |
| #时区_内罗毕 | 180 | 肯尼亚内罗毕 UTC+3 |
| #时区_亚的斯亚贝巴 | 180 | 埃塞俄比亚亚的斯亚贝巴 UTC+3 |
| #时区_莫斯科 | 180 | 俄罗斯莫斯科 UTC+3 |
| #时区_伊斯坦布尔 | 180 | 土耳其伊斯坦布尔 UTC+3 |
| #时区_德黑兰 | 210 | 伊朗德黑兰 UTC+3:30 |
| #时区_迪拜 | 240 | 阿联酋迪拜 UTC+4 |
| #时区_阿富汗 | 270 | 阿富汗喀布尔 UTC+4:30 |
| #时区_巴基斯坦 | 300 | 巴基斯坦卡拉奇 UTC+5 |
| #时区_塔什干 | 300 | 乌兹别克斯坦塔什干 UTC+5 |
| #时区_尼泊尔 | 345 | 尼泊尔加德满都 UTC+5:45 |
| #时区_印度 | 330 | 印度新德里 UTC+5:30 |
| #时区_斯里兰卡 | 330 | 斯里兰卡科伦坡 UTC+5:30 |
| #时区_孟加拉 | 360 | 孟加拉达卡 UTC+6 |
| #时区_阿拉木图 | 360 | 哈萨克斯坦阿拉木图 UTC+6 |
| #时区_缅甸 | 390 | 缅甸仰光 UTC+6:30 |
| #时区_雅加达 | 420 | 印尼雅加达 UTC+7 |
| #时区_曼谷 | 420 | 曼谷时间 UTC+7 |
| #时区_胡志明市 | 420 | 越南胡志明市 UTC+7 |
| #时区_金边 | 420 | 柬埔寨金边 UTC+7 |
| #时区_北京 | 480 | 北京时间 UTC+8 |
| #时区_香港 | 480 | 香港时间 UTC+8 |
| #时区_台北 | 480 | 台北时间 UTC+8 |
| #时区_澳门 | 480 | 澳门时间 UTC+8 |
| #时区_新加坡 | 480 | 新加坡时间 UTC+8 |
| #时区_吉隆坡 | 480 | 马来西亚吉隆坡 UTC+8 |
| #时区_马尼拉 | 480 | 菲律宾马尼拉 UTC+8 |
| #时区_巴厘岛 | 480 | 印尼巴厘岛 UTC+8 |
| #时区_珀斯 | 480 | 澳大利亚珀斯 UTC+8 |
| #时区_东京 | 540 | 东京时间 UTC+9 |
| #时区_首尔 | 540 | 首尔时间 UTC+9 |
| #时区_平壤 | 540 | 朝鲜平壤 UTC+9 |
| #时区_阿德莱德 | 570 | 澳大利亚阿德莱德 UTC+9:30 |
| #时区_悉尼 | 600 | 澳大利亚悉尼 UTC+10 |
| #时区_墨尔本 | 600 | 澳大利亚墨尔本 UTC+10 |
| #时区_关岛 | 600 | 美国关岛 UTC+10 |
| #时区_莫尔兹比港 | 600 | 巴布亚新几内亚 UTC+10 |
| #时区_新西兰 | 720 | 新西兰奥克兰 UTC+12 |
| #时区_斐济 | 720 | 斐济苏瓦 UTC+12 |
| #时区_查塔姆群岛 | 765 | 新西兰查塔姆群岛 UTC+12:45 |
| #时区_纽约 | -300 | 美国纽约 UTC-5 |
| #时区_多伦多 | -300 | 加拿大多伦多 UTC-5 |
| #时区_利马 | -300 | 秘鲁利马 UTC-5 |
| #时区_波哥大 | -300 | 哥伦比亚波哥大 UTC-5 |
| #时区_芝加哥 | -360 | 美国芝加哥 UTC-6 |
| #时区_墨西哥城 | -360 | 墨西哥城 UTC-6 |
| #时区_温尼伯 | -360 | 加拿大温尼伯 UTC-6 |
| #时区_丹佛 | -420 | 美国丹佛 UTC-7 |
| #时区_卡尔加里 | -420 | 加拿大卡尔加里 UTC-7 |
| #时区_洛杉矶 | -480 | 美国洛杉矶 UTC-8 |
| #时区_温哥华 | -480 | 加拿大温哥华 UTC-8 |
| #时区_阿拉斯加 | -540 | 美国阿拉斯加 UTC-9 |
| #时区_夏威夷 | -600 | 美国夏威夷 UTC-10 |
| #时区_萨摩亚 | -660 | 西萨摩亚 UTC-11 |
| #时区_圣保罗 | -180 | 巴西圣保罗 UTC-3 |
| #时区_布宜诺斯艾利斯 | -180 | 阿根廷布宜诺斯艾利斯 UTC-3 |
| #时区_纽芬兰 | -210 | 加拿大纽芬兰 UTC-3:30 |
| #时区_圣地亚哥 | -240 | 智利圣地亚哥 UTC-4 |
| #时区_加拉加斯 | -240 | 委内瑞拉加拉加斯 UTC-4 |
使用建议
- 开发优先使用 SDK 内置公开常量，禁止手写原始字符串 / 数字，统一代码规范，减少拼写错误；
- 生命周期、交互事件注册必须使用对应事件常量，不可手写底层事件字符串；
- 窗口主题默认推荐
#主题_自动，适配用户系统明暗偏好。
注意事项
- 常量底层为固定字符串 / 数字，直接手写原值可运行，但不利于后期维护；
- 切换窗口主题会触发页面重新渲染，短暂闪烁属于正常现象；
- Win7 / 旧版 Win10 不支持 Mica、Acrylic 透明材质，对应常量自动降级普通背景；
- 事件常量仅用于事件注册接口，不可用作 IPC 通讯通道名称；
- JAPK 相关错误码仅商用加密包场景返回，本地明文资源无相关错误。
相关 API
JadeView.App.注册事件()：绑定全部事件常量JadeView.窗口.设置主题/JadeView窗口设置.窗口主题：窗口主题、透明材质、标题栏、层级常量- 自定义数据类型
文件对话框选项：功能选项常量 - 自定义数据类型
提示框选项：对话框类型常量 - 自定义数据类型
托盘菜单选项：菜单项类型常量 JadeView.系统.注册全局热键：Alt/Ctrl/Shift/Win 修饰键常量JadeView.App.取路径：系统路径常量JadeView.时间.从授时中心获取：时区偏移常量JadeView.窗口.设置窗口进度:状态常量JadeView.右键菜单.创建：菜单项类型常量JadeView.窗口.设置层级：层级常量JadeView.窗口.设置边框样式：框架样式常量JadeView.窗口.设置背景材料：背景材料常量
总结
SDK 全部公开常量按功能场景表格化分类，覆盖窗口样式、系统路径、弹窗、热键、资源加密、生命周期事件、时区等全部开发场景，标准化传参，提升代码可读性与可维护性。
