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

福昕PDF SDK 软件开发工具包 | 福昕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（显示缩略图）。

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

GSDK如何设置 PDF 中链接注释的高亮模式（如取消高亮）？链接高亮有哪些可选模式？

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

GSDK如何设置 PDF 中链接注释的高亮模式（如取消高亮）？链接高亮有哪些可选模式？

GSDK如何通过代码控制 PDF 书签的折叠 / 展开状态？书签的 Count 属性具体含义是什么？

福昕高级PDF编辑器专业版+如何实现手机遥控PDF文档

福昕高级PDF编辑器专业版+如何实现批量对文档名称重命名

福昕高级PDF编辑器专业版+如何快速将发票生成报销单

福昕高级PDF编辑器专业版+如何将PDF转换为office格式实现在线编辑

电子签章对外签署如何实现批量签署文档

GSDK如何缩放 PDF 页面内容并调整页面大小为 Letter 规格？调整过程中如何避免内容偏移？

GSDK如何将 Word 文件转换为 PDF?

GSDK如何获取 PDF 文档的访问权限（如打印、修改权限）？userPermissions 返回值的比特位具体含义是什么？

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

GSDK如何设置 PDF 中链接注释的高亮模式（如取消高亮）？链接高亮有哪些可选模式？

GSDK如何通过代码控制 PDF 书签的折叠 / 展开状态？书签的 Count 属性具体含义是什么？

福昕高级PDF编辑器专业版+如何实现手机遥控PDF文档

福昕高级PDF编辑器专业版+如何实现批量对文档名称重命名

福昕高级PDF编辑器专业版+如何快速将发票生成报销单

福昕高级PDF编辑器专业版+如何将PDF转换为office格式实现在线编辑