Qt阅读器-缩略图

1. 功能概述

缩略图功能用于在阅读器左侧边栏展示文档页面预览,帮助用户快速识别页面内容并跳转到目标页面。

用户在阅读文档时,可以通过左侧边栏中的"页面"按钮打开缩略图视图。缩略图视图以列表形式展示文档每一页的预览图和页码,用户点击某一页缩略图后,阅读区会立即跳转到对应页面。

该功能适用于页数较多、版式差异明显、需要频繁跨页查看的文档场景。

2. 功能目标

  • 提供文档页面的可视化导航能力。
  • 帮助用户通过页面外观快速定位目标页。
  • 支持从目录视图切换到页面缩略图视图。
  • 支持点击缩略图快速跳转页面。
  • 支持当前阅读页与缩略图选中状态同步。
  • 保持左侧边栏交互一致,不影响主阅读区使用。

3. 使用入口

缩略图入口位于阅读器左侧边栏。

左侧边栏包含与目录同级的页面按钮:

  • 点击目录按钮,显示文档目录。
  • 点击页面按钮,显示页面缩略图。

如果左侧边栏处于收起状态,点击目录或页面按钮时,边栏会展开并显示对应内容。

4. 页面缩略图视图

页面缩略图视图以纵向列表展示文档页面。

每个页面项包含:

  • 页面预览图。
  • 页码。
  • 当前页选中状态。

当某一页缩略图尚未加载完成时,页面项会显示加载占位,加载完成后自动替换为页面预览图。

5. 页面跳转

用户可以通过以下方式跳转页面:

  • 点击某一页缩略图。
  • 阅读区立即滚动到对应页面。
  • 底部页码状态同步更新。

页面跳转后,该页缩略图会进入选中状态,方便用户确认当前位置。

6. 当前页同步

当用户在主阅读区滚动或翻页时,缩略图视图会同步当前阅读位置。

同步规则如下:

  • 当前阅读页对应的缩略图会高亮显示。
  • 当缩略图视图处于打开状态时,当前页会尽量保持在列表可见区域内。
  • 当用户切换回缩略图视图时,会自动定位到当前阅读页。

7. 与目录功能的关系

目录和缩略图是左侧边栏中的两种导航方式。

目录适合按照文档结构跳转,例如章节、标题、书签。

缩略图适合按照页面外观跳转,例如封面、签章页、表格页、图片页、附件页。

两种视图互不影响,用户可以根据当前阅读任务自由切换。

8. 支持的文档类型

当前缩略图功能支持:

  • PDF 文档。
  • OFD 文档。
  • 加密文档打开后的页面预览。

如果文档带有水印,缩略图预览会尽量保持与阅读区页面显示一致。

9. 加载与性能

缩略图采用按需加载方式。

系统不会在打开文档时立即生成所有页面缩略图,而是在用户查看缩略图列表或当前页需要展示时逐步加载。这样可以减少大文档打开时的等待时间,保持阅读器响应流畅。

对于页数较多的文档,用户可能会看到部分页面先显示加载占位,随后逐步出现页面预览。