GSDK如何修改 PDF 打开时的初始页面布局（如双页显示）？除了布局，还能设置哪些初始视图参数？

福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(桌面/服务器)

标签:
视图

GSDK如何修改 PDF 打开时的初始页面布局（如双页显示）？除了布局，还能设置哪些初始视图参数？

福昕知识库
2025-12-08

PDF 的初始视图由文档目录字典（Catalog）的属性控制，其中PageLayout定义页面布局，OpenAction定义初始页码 / 缩放比例，PageMode定义是否显示书签 / 缩略图等，具体实现如下：

PageLayout 可选值及效果

属性值	含义	适用场景
SinglePage	单页显示（默认）	图文密集的文档
OneColumn	单列连续显示	长文本文档
TwoColumnLeft	双列左对齐（奇数页左）	书籍类文档（从左翻页）
TwoColumnRight	双列右对齐（奇数页右）	西式书籍
TwoPageLeft	双页左对齐（两页为一组）	画册 / 杂志
TwoPageRight	双页右对齐（两页为一组）	标准图书排版

完整示例（设置双页右对齐 + 初始缩放 100%）

import com.foxit.sdk.PDFDoc;
import com.foxit.sdk.PDFDictionary;
import com.foxit.sdk.PDFObject;
import com.foxit.sdk.Action;
import com.foxit.sdk.GotoAction;
import com.foxit.sdk.common.ErrorCode;

public class PDFInitialViewDemo {
    public static void main(String[] args) {
        // 初始化SDK（省略）
        PDFDoc doc = new PDFDoc("test.pdf");
        if (doc.load(null) != ErrorCode.e_ErrSuccess) {
            System.out.println("文档加载失败");
            return;
        }

        // 1. 获取文档目录字典
        PDFDictionary catalog = doc.getCatalog();
        if (catalog == null) return;

        // 2. 设置页面布局为“双页右对齐”
        PDFObject layoutObj = PDFObject.createFromString("TwoPageRight");
        catalog.setAt("PageLayout", layoutObj);

        // 3. 扩展：设置初始页码为第1页，缩放比例100%
        GotoAction gotoAction = new GotoAction();
        // 设置目标页面（索引从0开始，对应第1页）
        gotoAction.setDestPage(doc.getPage(0));
        // 设置缩放模式为100%（e_ZoomFixed：固定缩放比例）
        gotoAction.setZoomMode(GotoAction.e_ZoomFixed, 1.0f);
        Action openAction = gotoAction;
        catalog.setAt("OpenAction", openAction.getDict());

        // 4. 扩展：设置打开时显示书签面板
        PDFObject pageModeObj = PDFObject.createFromString("UseOutlines");
        catalog.setAt("PageMode", pageModeObj);

        // 保存修改
        doc.save(PDFDoc.e_SaveFlagNoIncremental, null);
        doc.close();
        Library.release();
    }
}

注意事项

兼容性：部分轻量级 PDF 阅读器（如移动端）可能不支持TwoPageLeft/Right等布局，需测试验证；
生效条件：修改后需重新打开 PDF 才能看到初始视图变化；
PageMode 可选值：UseNone（仅显示页面）、UseOutlines（显示书签）、UseThumbs（显示缩略图）。

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

打印管理PrintManager怎么判断文档打印是否完成？

软件如何打开嵌入在office文档中Adobe PDF图标

福昕高级PDF编辑器专业版如何在文档中嵌入一个3D模型

福昕高级PDF编辑器专业版如何实现对图片和文档内容添加马赛克

福昕高级PDF编辑器如何显示注释内容图标

福昕高级PDF编辑器如何添加和调整快速访问工具栏功能

RDK Android 如何设置单页上下滑动翻页？

PDF转Word时，如何仅处理指定页面？

PDF和OFD如何批量互转？

Bitmap 类如何与其他的图像类互转？

打印管理PrintManager怎么判断文档打印是否完成？

软件如何打开嵌入在office文档中Adobe PDF图标

福昕高级PDF编辑器专业版如何在文档中嵌入一个3D模型

福昕高级PDF编辑器专业版如何实现对图片和文档内容添加马赛克

福昕高级PDF编辑器如何显示注释内容图标

福昕高级PDF编辑器如何添加和调整快速访问工具栏功能