Guides

显示模式

ComPDF 支持单页、双页和书本模式显示文档，并提供翻页和连续滚动两种阅读方式，同时支持裁切模式和视图模式配置。

快速示例

以下示例将查看器设置为单页连续模式：

• 单页模式：关闭双页显示。
• 连续模式：开启连续滚动。

readerView.setDoublePageMode(false);
readerView.setContinueMode(true);

模式配置项说明

下表汇总了常用显示模式配置项及对应方法：

配置项	方法	说明
滚动方向	setVerticalMode(boolean vertical)	true 表示垂直滚动，false 表示水平滚动。
单页或双页	setDoublePageMode(boolean doublePage)	true 表示双页显示，false 表示单页显示。
连续滚动	setContinueMode(boolean continuous)	true 表示连续滚动模式。
书本模式	setCoverPageMode(boolean coverPage)	通常与双页模式配合使用，用于按书本形式显示首页。

以下示例展示各配置项的设置方式。

设置滚动方向：

// 垂直滚动
readerView.setVerticalMode(true);
// 水平滚动
readerView.setVerticalMode(false);

设置单页或双页模式：

// 双页显示
readerView.setDoublePageMode(true);
// 单页显示
readerView.setDoublePageMode(false);

设置连续滚动模式：

readerView.setContinueMode(true);

设置书本模式：

readerView.setDoublePageMode(true);
readerView.setCoverPageMode(true);

裁切模式

裁切模式用于调整页面可见区域，适合隐藏页面多余留白，提升阅读区域利用率。

以下是设置裁切模式的关键代码：

readerView.setCropMode(true);

视图模式

在使用 CPDFReaderView 时，不同业务场景可通过 readerView.setViewMode(ViewMode viewMode) 切换视图模式，例如阅读、注释编辑和文档编辑场景。

可按以下场景选择视图模式：

• VIEW：适用于阅读文档和填写表单。
• ANNOT：适用于添加、删除和编辑注释。
• FORM：适用于编辑表单结构和属性。
• PDFEDIT：适用于编辑文档中的文字和图片。
• ALL：适用于同时处理表单和注释。

视图模式	适用场景	限制
VIEW	阅读文档、填写表单	不支持注释添加、选取、移动、删除和属性编辑；不支持表单添加、选取、移动、删除和属性编辑。
ANNOT	添加、删除和编辑注释	不支持表单填写；不支持表单添加、选取、移动、删除和属性编辑；不支持文档文字和图片编辑。
FORM	编辑表单结构和属性	不支持注释添加、选取、移动、删除和属性编辑；不支持表单填写。
PDFEDIT	编辑文档文字和图片	不支持注释添加、选取、移动、删除和属性编辑；不支持表单填写；不支持表单添加、选取、移动、删除和属性编辑。
ALL	同时处理表单和注释	不支持表单填写；不支持文档文字和图片编辑。