Windows 驱动实例分析系列:libwdi 驱动分析 - examples 篇(四)

子文档四:Zadig UI 与标准对话框模块

Zadig 的用户界面完全使用 Win32 原生控件构建,未使用任何第三方 UI 库。其 UI 相关代码主要分布在 zadig_stdlg.c 和 zadig.c 的主窗口过程部分。本子文档重点分析 zadig_stdlg.c 中实现的标准对话框和辅助 UI 组件。

文件夹浏览对话框

BrowseForFolder 函数实现了文件夹选择功能,用于让用户指定驱动文件的提取目录。它同时支持两种实现路径:

  1. 首选路径 :使用 Windows Vista 及以后引入的 IFileOpenDialog(设置 FOS_PICKFOLDERS 选项),提供更现代的界面和更好的高 DPI 支持。
  2. 回退路径 :若 IFileOpenDialog 不可用(如 Windows XP),则使用传统的 SHBrowseForFolder API。

BrowseForFolder 还通过子类化 SHBrowseForFolder 的编辑框控件,实现了用户可以直接在编辑框中输入路径的功能,提升了易用性。

文件对话框(打开/保存)

FileDialog 函数封装了 IFileDialog(Vista+)和传统的 GetOpenFileName/GetSaveFileName,支持自定义文件类型过滤器。它接受一个 ext_t 结构体,其中定义了文件扩展名和对应的描述,用于构建过滤器字符串。

FileDialog 还处理了 UTF-8 路径的转换:内部将传入的 UTF-8 路径转换为 UTF-16 调用 Windows API,返回时将结果转换回 UTF-8,确保在整个应用程序中字符串编码统一。

自定义通知对话框

zadig_stdlg.c 实现了 notification 函数和对应的对话框过程 notification_callback,用于替代标准的 MessageBox,提供以下增强功能:

  • 自定义图标(支持信息、警告、错误、询问四种类型)。
  • 可选的"更多信息"按钮,用于打开一个额外的对话框(如更新策略详情)。
  • 居中于父窗口,且禁用窗口最大化/调整大小,防止用户意外操作。
  • 模态行为,阻塞父窗口直到用户响应。

该通知对话框在 Zadig 中广泛用于显示操作结果、警告信息以及询问用户是否允许更新检查等。

关于对话框

about_callback 实现了关于对话框,其特殊之处在于:

  • 使用 Rich Edit 控件(RichEdit20W)显示 RTF 格式的版权声明和附加版权信息。
  • 支持超链接自动检测(EM_AUTOURLDETECT)和点击打开(通过 EN_LINK 通知)。
  • 包含一个"许可证"按钮,点击后显示 GPLv3 全文的模态对话框。
  • 包含一个"更新策略"按钮,点击后显示更新策略对话框。

关于对话框的版权文本定义在 zadig_license.h 中,包括主程序版权、libwdi 版权、profile.c 版权等,充分尊重了所有依赖项目的许可证要求。

更新策略对话框

UpdateCallback 实现了更新策略设置对话框,允许用户配置:

  • 更新检查频率(禁用/每日/每周/每月/自定义)。
  • 是否包含测试版(Beta)更新。
  • 手动触发立即检查。

该对话框将用户的偏好存储到注册表(HKCU\Software\Akeo Consulting\Zadig\)中,并在下次启动时应用。

新版本通知对话框

当检测到新版本时,Zadig 会显示 new_version_callback 对话框。该对话框包含:

  • 当前版本和最新版本的对比显示。
  • 发布说明(RTF 格式,支持超链接)。
  • "下载"按钮,点击后启动后台下载线程,并在进度条上显示下载进度。
  • 下载完成后,按钮变为"启动",点击后启动新版本的可执行文件,并关闭当前 Zadig 实例。

该实现展示了如何结合多线程和进度条实现流畅的用户体验。

工具提示(Tooltip)管理

zadig_stdlg.c 中实现了 create_tooltip、destroy_tooltip 和 destroy_all_tooltips 三个函数,用于为控件添加自定义提示。它们维护了一个全局数组 ttlist,存储每个工具提示的句柄、原始窗口过程和 UTF-8 字符串。工具提示支持多行文本,并可以设置显示时长。

Zadig 为几乎所有控件都添加了工具提示,极大地提升了软件的易用性。

状态栏

create_status_bar 函数创建了一个状态栏(STATUSCLASSNAME),分为两个部分:左侧用于显示动态提示信息,右侧用于显示应用程序版本号。版本号部分使用了自定义绘制(WM_DRAWITEM),以灰色文字显示,与状态栏背景协调。


相关推荐
goehou7 小时前
让 AI 替我操作这台电脑,先把手能伸多远定下来
windows·自动化·权限管理·ai agent
公子小六8 小时前
基于.NET的Windows窗体编程之WinForms数据持久化(1)
windows·microsoft·c#·.net·winforms
2601_967987371 天前
安装 Redis 或 Redis Stack
linux·windows·redis·macos·安装
xbzb1 天前
自定义 yum 软件源:Linux 上 createrepo,Windows 上纯 Python 也能造
linux·运维·windows·python·yum·createrepo
武雄(小星Ai)1 天前
Ollama报llama-server binary not found排坑实录:服务活着引擎没了
人工智能·windows·大模型·ollama·排坑
LabVIEW开发1 天前
AI 如何接进 LabVIEW:链路怎么搭、边界在哪、还差什么
人工智能·驱动开发·labview
叼烟扛炮2 天前
[LangChain] 学习笔记(06):突破大模型限制——结构化输出(Structured Output)
windows·笔记·学习·langchain
Thneonl2 天前
桌宠穿透不是一行 SetWindowLong
windows·程序员
女神下凡3 天前
芯参谋(95):嵌入式文件系统_开发指南
linux·服务器·arm开发·驱动开发·设计规范
艺杯羹3 天前
Windows原生软件锁设计:从暴力杀进程丢数据到零轮询事件驱动架构
windows·系统架构·开源·开源软件·内存管理·开源协议