企业官网建设流程全解析

子文档四：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），则使用传统的SHBrowseForFolderAPI。

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），以灰色文字显示，与状态栏背景协调。