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（显示缩略图）。

如何高亮表单域、自定义表单域颜色以及重置表单？

文档中的文字变的不光滑，而是锯齿形状，怎么能调整回来呢？

如何将表单数据导出和导入？

如何把word/Excel中的表格做成表单？

如何高亮表单域、自定义表单域颜色以及重置表单？

文档中的文字变的不光滑，而是锯齿形状，怎么能调整回来呢？

如何将表单数据导出和导入？

如何把word/Excel中的表格做成表单？

如何在PDF中根据表单内容生成二维码？

为什么从其他pdf文件复制过来的文本和图片都无法编辑？

如何添加音视频并使用呢？

修改密码点击“忘记密码”无反应，打不开修改密码页面，咋办

OFD与PDF文件如何批量互转？

如何将pdf文件转为纯图片的PDF呢？

如何高亮表单域、自定义表单域颜色以及重置表单？

文档中的文字变的不光滑，而是锯齿形状，怎么能调整回来呢？

如何将表单数据导出和导入？

如何把word/Excel中的表格做成表单？

如何在PDF中根据表单内容生成二维码？

为什么从其他pdf文件复制过来的文本和图片都无法编辑？

如何添加音视频并使用呢？

修改密码点击“忘记密码”无反应，打不开修改密码页面，咋办

OFD与PDF文件如何批量互转？

如何将pdf文件转为纯图片的PDF呢？