Qt 铁甲阅读器-搜索
1. 功能简介
文档搜索是阅读器中的基础检索功能。用户打开 PDF、OFD 或加密文档后，可以在阅读界面中输入关键词，快速查找文档正文中的匹配内容，并通过结果列表跳转到对应页面和原文位置。
该功能主要用于在长文档中定位条款、编号、姓名、金额、日期、关键词或其他关键信息。搜索基于文档可提取的文字层，不包含图片文字识别。
2. 适用场景
- 在合同、制度、档案、报告中查找指定关键词。
- 快速定位某个条款、金额、名称或编号。
- 在当前页内查找内容，避免全篇搜索干扰。
- 在长文档中边检索边查看已找到的结果。
- 通过高亮内容核对搜索命中的原文位置。
3. 支持的文档
当前版本支持：
- 可提取文字的 PDF 文档。
- 可提取文字的 OFD 文档。
- 阅读器已成功打开的加密文档。
- 单份文档内搜索。
- 中文、英文、数字和符号关键词搜索。
当前版本暂不支持：
- 扫描件或纯图片文档的 OCR 搜索。
- 多文档跨文件搜索。
- 正则表达式搜索。
- 搜索历史和收藏搜索条件。
- 搜索结果导出。
4. 使用入口
用户可以通过以下方式打开搜索面板：
- 点击阅读工具栏中的“搜索”按钮。
- 使用快捷键
Ctrl+F。
搜索面板打开后显示在阅读区域右侧。用户按Esc或点击关闭按钮可以关闭搜索面板，并清除当前搜索高亮。
5. 使用流程
- 打开一个文档。
- 点击“搜索”按钮或按
Ctrl+F。 - 在搜索输入框中输入关键词。
- 系统在短暂延迟后自动开始搜索。
- 搜索过程中显示检索进度和已找到结果数。
- 结果列表会随着检索进度逐步追加显示。
- 点击结果项，文档自动跳转到对应原文位置。
- 点击“上一个”或“下一个”可以在结果之间切换。
- 修改关键词或搜索选项后，系统会取消当前搜索并重新开始。
6. 搜索选项
6.1 区分大小写
开启后，搜索会区分英文大小写。例如搜索PDF时不会匹配pdf。
关闭后，大小写不同但文字相同的内容也会被匹配。
6.2 全字匹配
开启后，系统只匹配完整词。适用于英文、数字编号或带边界含义的关键词。
例如搜索art时，全字匹配不会命中party中的art。
6.3 仅当前页
开启后，系统只搜索当前阅读页。
当用户翻到其他页面时，如果搜索面板仍打开且关键词不为空，当前页搜索会自动按新页面重新执行。
关闭后，系统搜索整份文档。
7. 异步检索与进度
为避免页数较多的文档搜索时界面卡顿，搜索采用按页增量检索：
- 系统不会一次性阻塞搜索完整份文档。
- 搜索任务按页面逐步执行。
- 面板会显示当前已检索页数、总页数和已找到结果数。
- 已搜索到的结果会立即追加到结果列表中。
- 用户可以在搜索尚未完成时点击已出现的结果并跳转查看。
进度文案示例：
正在检索 12 / 80 页，已找到 5 个结果搜索完成后，如果存在结果，状态显示当前选中结果和结果总数，例如：
1 / 18 个结果如果没有找到结果，系统提示：
未找到匹配内容。若文档是扫描件，当前版本无法搜索图片文字。8. 结果展示与定位
搜索结果列表展示每条命中的页码和上下文预览。
用户点击结果后：
- 阅读器跳转到命中所在页面。
- 命中的文字区域显示搜索高亮。
- 当前选中的结果使用更醒目的高亮状态。
- 结果列表同步选中当前结果。
用户点击“上一个”或“下一个”时，系统会在当前已找到的结果中循环切换。搜索仍在进行时，新结果会继续追加到列表末尾。
9. 取消与重置
以下操作会取消当前搜索任务：
- 修改搜索关键词。
- 切换搜索选项。
- 关闭搜索面板。
- 打开新文档或释放当前文档。
- 切换到水印、AI 合同审查或 AI 问文档等其他右侧面板功能。
取消后，当前结果列表、进度条和文档高亮会被清理，避免旧结果和新搜索条件混在一起。