Files
dxdesigner-part-replacement/docs/user/frosted-ui.md
T

31 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 磨砂界面
任务中心现使用 Windows 原生 Acrylic 处理顶栏与任务侧栏的背景模糊。位号、料号规则、日志和对话框的数据区域保持实色,避免背景干扰读数。界面中的 SVG 图标随源代码一起打包,不需要联网加载。
右上角 **减少透明度** 可切换为实色外壳,该选择保存在当前数据目录的布局设置中。系统关闭透明效果、启用高对比度、远程会话、非 Windows 或不支持的环境也会使用实色。程序只读取系统偏好,不修改 Windows 设置。
工程名称与完整路径现在位于表格上方。点击 **工程设置** 可展开原有 Value 策略与关闭归档选项。执行、暂停、核验恢复、BOM 校验及任务数据规则继续使用原有机制。
本次修改的是源代码运行的正式 PySide6 窗口,不是网页嵌入的演示界面。旧版便携 EXE 不会自动获得此界面;需要重新构建便携包。可在项目已安装依赖的 Python 3.12 环境中使用已安装的 `dx-part-replace-gui` 入口启动。
本机验证环境为 Windows 11 build 26200、125% 缩放。Windows 10、其他显卡/驱动、多显示器、远程会话和打包后的原生效果仍需要相应环境验收,不能只根据系统接口返回成功判断视觉效果。
任务侧栏顶部提供新建,底部 **任务管理** 菜单提供编辑、恢复、顺序调整与删除。排序从任务数量旁的图标菜单选择。位号工具栏合并搜索、BOM 导入与采集;保存计划位于表格底部。执行区右上角的更多菜单保留诊断、资源清理、轮次证据与布局入口。执行期间,**完成当前项后暂停** 和 **强制结束…** 直接显示在主按钮行;请求安全暂停后,强制结束入口仍保留。强制结束继续要求确认并保留中断核验保护。
搜索使用 `Ctrl+F`,`F3` 跳至下一条,`Ctrl+S` 保存位号计划。搜索会显示匹配数量,清空后恢复全部行;过滤不改变真实执行范围。蓝色行选中用于批量填写,替换复选框才决定计划中的替换项。保存前会提交正在编辑的单元格,按 `Esc` 可取消当前单元格编辑。
## 材质接口与支持矩阵
当前原生模糊使用未文档化的 `SetWindowCompositionAttribute` / `WCA_ACCENT_POLICY=19`(Accent state 4)。这是一项 Windows 兼容性依赖,系统接口返回成功并不能保证每种驱动/窗口状态都有相同外观。Win11 的 `DwmSetWindowAttribute(SYSTEMBACKDROP_TYPE)` 在早期隔离 Qt 对照实验中没有产生预期背景模糊,因此当前没有自动切换到该路径;实验和开源参考见 `docs/reviews/2026-10-30-ui/github-material-research.md`。
| 环境 | 当前行为与验证范围 |
| --- | --- |
| Windows 11 build 26200,125% 缩放,普通窗口 | 已验证原生背景变化、实色表格、减少透明度和 980×700 布局 |
| Windows 10 build 17763 及以上、其他 Windows 11 build/驱动 | 满足策略条件时尝试 Acrylic;原生 API 失败时使用实色;仍需对应设备视觉验收 |
| 最大化、跨显示器、不同 DPI、显卡驱动切换 | 不承诺上述单机验证结果;如出现黑边或模糊异常,可使用“减少透明度”切回实色 |
| 远程会话、系统关闭透明效果 | 禁用 Acrylic,使用实色 |
| Windows 高对比度 | 禁用 Acrylic;窗口回退绘制与基础控件表面使用 Qt 系统调色板 |
| 非 Windows、旧版 Windows、不支持原生 API | 使用实色,不尝试窗口模糊 |
显示、重新激活窗口和系统调色板事件会重新检查策略;窗口可见时另每 30 秒检查一次,隐藏时不读取注册表/SPI。默认实色背景由 `ui/theme.py` 与 QSS 共用,避免窗口绘制和控件背景色分离。当前没有提供独立的深色主题。