Guides
配置页面缩放行为
页面缩放用于控制 PDF 在阅读器中的显示比例。缩放配置通常用于以下场景：
- 为首屏阅读设置默认放大比例。
- 在特定业务流程中切换到指定缩放级别。
- 配置双击后的缩放交互方式。
本页说明程序化设置缩放比例以及双击缩放的基础配置方式。
适用场景
页面缩放设置通常用于以下场景：
- 文档默认字号较小，需要在打开后提高阅读清晰度。
- 特定页面需要放大查看细节，例如图纸、表格或票据。
- 阅读器需要保留双击放大交互，或者明确关闭该行为。
设置页面缩放比例
CPDFReaderView 支持通过 setScale(...) 直接设置当前页面的缩放比例。
java
readerView.setScale(5);这段代码表示将阅读器缩放到 5 倍显示比例。
如果页面需要在文档显示后立即进入指定放大级别，通常可以在文档绑定完成、阅读器进入可操作状态后调用该方法。
启用双击缩放
如果阅读器需要保留双击放大交互，可以启用 setEnableDoubleClickScale(...)。
java
readerView.setEnableDoubleClickScale(true);启用后，双击页面时，阅读器会按照 SDK 当前的缩放逻辑切换显示比例。
组合使用缩放配置
页面缩放通常会和默认阅读模式一起配置。例如，文档打开后先进入某个显示模式，再设置缩放比例，同时保留双击缩放交互。
java
readerView.setScale(5);
readerView.setEnableDoubleClickScale(true);这种组合更适合需要放大阅读细节，同时仍保留常规阅读交互的页面。
使用缩放配置时的注意事项
setScale(...)调整的是当前阅读器显示比例，不会修改磁盘上的 PDF 文档内容。- 缩放比例越高，单页内容显示越大，适合查看细节，但可视区域会相应缩小。
- 如果页面已经依赖手势缩放或双击缩放交互，程序化设置比例时应结合业务流程安排调用时机，避免与用户操作预期冲突。
- 缩放通常与 显示模式 配合使用，以便同时控制滚动方向、单双页模式和显示比例。