Guides

配置页面缩放行为

页面缩放用于控制 PDF 在阅读器中的显示比例。缩放配置通常用于以下场景：

• 为首屏阅读设置默认放大比例。
• 在特定业务流程中切换到指定缩放级别。
• 配置双击后的缩放交互方式。

本页说明程序化设置缩放比例以及双击缩放的基础配置方式。

适用场景

页面缩放设置通常用于以下场景：

• 文档默认字号较小，需要在打开后提高阅读清晰度。
• 特定页面需要放大查看细节，例如图纸、表格或票据。
• 阅读器需要保留双击放大交互，或者明确关闭该行为。

设置页面缩放比例

CPDFReaderView 支持通过 setScale(...) 直接设置当前页面的缩放比例。

readerView.setScale(5);

这段代码表示将阅读器缩放到 5 倍显示比例。

如果页面需要在文档显示后立即进入指定放大级别，通常可以在文档绑定完成、阅读器进入可操作状态后调用该方法。

启用双击缩放

如果阅读器需要保留双击放大交互，可以启用 setEnableDoubleClickScale(...)。

readerView.setEnableDoubleClickScale(true);

启用后，双击页面时，阅读器会按照 SDK 当前的缩放逻辑切换显示比例。

组合使用缩放配置

页面缩放通常会和默认阅读模式一起配置。例如，文档打开后先进入某个显示模式，再设置缩放比例，同时保留双击缩放交互。

readerView.setScale(5);
readerView.setEnableDoubleClickScale(true);

这种组合更适合需要放大阅读细节，同时仍保留常规阅读交互的页面。

使用缩放配置时的注意事项

• setScale(...) 调整的是当前阅读器显示比例，不会修改磁盘上的 PDF 文档内容。
• 缩放比例越高，单页内容显示越大，适合查看细节，但可视区域会相应缩小。
• 如果页面已经依赖手势缩放或双击缩放交互，程序化设置比例时应结合业务流程安排调用时机，避免与用户操作预期冲突。
• 缩放通常与 显示模式 配合使用，以便同时控制滚动方向、单双页模式和显示比例。

相关章节

• 阅读器显示模式配置，参见 显示模式。
• 页码跳转和阅读位置同步，参见 页面导航。