UI 能力概览
本文概览福昕 PDF SDK 鸿蒙版在 UIExtensions（及 Complete Viewer 演示壳）上提供的阅读器界面能力。底层 Core API 见左侧「核心功能」各页；模块开关与属性默认值见 使用配置文件自定义 UI 及 配置项说明。
基础阅读与导航
| 能力 | 说明 |
|---|---|
| 文档打开与阅读 | Complete Viewer / 集成应用中打开 PDF；支持单页、双页、封面、连续滚动、适应宽度 / 高度 / 页面等（pageMode / continuous / zoomMode） |
| 页面导航 | 页码跳转、翻页；可开启底部页码滑动条（enablePageSlider） |
| 文本搜索 | 搜索面板：精确搜索（modules.search） |
| 选择工具 | 页面文本拖选与复制（modules.selection；受 permissions.copyText 与文档权限影响） |
| 链接 | 点击 PDF 链接跳转 / 操作（permissions.enableLink） |
| 撤销 / 重做 | 注释等操作的撤销与重做 |
面板与文档结构
| 能力 | 说明 |
|---|---|
| 大纲（Outline） | 文档书签树导航（modules.outline） |
| 阅读书签 | 应用内阅读进度 / 兴趣点标记（modules.readingbookmark） |
| 注释列表面板 | 浏览、定位文档中的注释 |
| 附件面板 | 文档级附件查看与管理（modules.attachment） |
| 签名面板 | 与数字签名相关的列表 / 管理入口（modules.signature） |
| 页面缩略图 | 已打开文档的页面预览与页面管理（modules.thumbnail） |
| 文件列表封面缩略图 | Complete Viewer 首页「最近 / 全部文件」的 PDF 封面预览（区别于页面缩略图） |
| 文档信息 | 查看文档属性等信息 |
注释工具
可通过 modules.annotations.* 按类型开关。常用类型包括：
| 类别 | 能力 |
|---|---|
| 文本标记 | 高亮、下划线、波浪线、删除线、插入、替换 |
| 便笺与自由文本 | 便签（Note）、打字机、文本框、标注（Callout） |
| 形状与绘图 | 直线、箭头、矩形、椭圆、多边形、云朵、折线、铅笔（墨迹）、橡皮擦 |
| 图章 / 图片 / 多媒体 | 图章、图片注释、音频、视频 |
| 测量 | 距离等测量注释 |
| 密文 | 标记与应用密文（Redaction）；亦可从选中文本快速标记 |
| 注释多选 | 框选多选，批量复制 / 粘贴 / 删除 / 移动缩放与分组（modules.multipleSelection） |
| Popup / 回复 | markup 关联 Popup；支持回复线程 |
| 扁平化 | 文档级或单条注释扁平化 |
表单与签名
| 能力 | 说明 |
|---|---|
| 表单填写 | AcroForm 填写与交互（modules.form）；表单域高亮、表单导航条可配 |
| 表单域文本编辑 | 可编辑文本的复制 / 剪切 / 粘贴 / 全选等（如文本域、可编辑组合框） |
| 动态 XFA | 动态 XFA 渲染与交互（文本、选择、下拉等）；部分视图能力在 XFA 下不可用 |
| 填写并签名（Fill & Sign） | 填写内容与签名外观工作区（modules.fillSign；区别于数字签名） |
| 数字签名 | 签名、验签等相关 UI（modules.signature） |
| JavaScript | 表单等场景下的 JS 执行开关（permissions.runJavaScript） |
视图与显示
| 能力 | 说明 |
|---|---|
| 重排 / 裁剪 / 自动翻页 / 平移与缩放 | 视图设置中的阅读增强模式；动态 XFA 下重排、裁剪、平移与缩放通常不可用 |
| 深色主题 | 系统 UI 深色主题资源适配（跟随 HarmonyOS 系统深色） |
| 夜间模式 | PDF 页面颜色映射（colorMode：Normal / Night / Map），与深色主题不同 |
| 仅触控笔绘制 | 墨迹场景可限制为触控笔输入（showPenOnlySwitch / stylusOnly） |
文档处理与保护
| 能力 | 说明 |
|---|---|
| 文件对比 | 对比两份 PDF，颜色图例展示插入 / 删除 / 替换；支持标准密码加密；不支持 XFA / Wrapper / 证书加密等 |
| 打印 | More → 打印；调用系统打印框架输出 PDF（依赖 SystemCapability.Print.PrintFramework；受文档打印权限约束）。OpenHarmony 通常不可用 |
| 密码加密 | More → 保护 → 文件加密（modules.encryption） |
| 另存为 / 减小文件体积 / 截屏 | More 菜单中的文档处理入口 |
| 小结注释 / 导出高亮文本 / 重置表单域 | More → 注释与字段相关入口 |
界面定制
| 能力 | 说明 |
|---|---|
| 全屏与工具栏显隐 | 点击空白切换工具栏；配置与 API 控制顶栏 / 底栏及自动全屏 |
| 自定义长按菜单 | 菜单弹出前增删改菜单项与样式（选中文本 / 空白 / 批注 / 工具等场景） |
| ToolBar 扩展 | 自定义 Home 工具、菜单排序、工具栏位置；全屏底栏快捷入口等 |
| 顶栏可拖动 | enableTopbarDraggable：按手机 / 平板策略启用 |
详细配置与示例见 使用配置文件自定义 UI。
辅助阅读
| 能力 | 说明 | 注意 |
|---|---|---|
| TTS 朗读 | 选中文本菜单或视图设置启动 | 依赖设备 TTS；动态 XFA、OpenHarmony 通常不可用 |