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

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

标签:
书签

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

福昕知识库
2025-12-08

PDF 书签（Bookmark）的折叠 / 展开状态由其字典中的Count属性控制，这是 PDF 规范定义的核心属性，具体实现如下：

原理说明

Count为正数：表示书签处于「展开」状态，数值等于直接子书签的数量；
Count为负数：表示书签处于「折叠」状态，绝对值等于直接子书签的数量；
无Count属性：表示该书签无下级子书签，无需折叠 / 展开。

完整示例（批量折叠一级书签）

import com.foxit.sdk.PDFDoc;
import com.foxit.sdk.Bookmark;
import com.foxit.sdk.PDFDictionary;
import com.foxit.sdk.PDFObject;
import com.foxit.sdk.common.ErrorCode;

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

        // 1. 获取书签根节点
        Bookmark rootBookmark = doc.getRootBookmark();
        if (rootBookmark.isEmpty()) {
            System.out.println("文档无书签");
            return;
        }

        // 2. 遍历所有一级子书签
        Bookmark currentBookmark = rootBookmark.getFirstChild();
        while (!currentBookmark.isEmpty()) {
            // 获取书签字典
            PDFDictionary bookmarkDict = currentBookmark.getDict();
            if (bookmarkDict == null) {
                currentBookmark = currentBookmark.getNextSibling();
                continue;
            }

            // 3. 获取当前Count值，判断是否有子书签
            PDFObject countObj = bookmarkDict.getElement("Count");
            if (countObj != null && countObj.isNumber()) {
                int currentCount = countObj.getInteger();
                if (currentCount > 0) {
                    // 展开状态→折叠：将Count设为负值
                    PDFObject newCountObj = PDFObject.createFromInteger(-currentCount);
                    bookmarkDict.setAt("Count", newCountObj);
                    System.out.println("书签「" + currentBookmark.getTitle() + "」已折叠");
                } else if (currentCount < 0) {
                    // 折叠状态→展开：将Count设为正值
                    PDFObject newCountObj = PDFObject.createFromInteger(-currentCount);
                    bookmarkDict.setAt("Count", newCountObj);
                    System.out.println("书签「" + currentBookmark.getTitle() + "」已展开");
                }
            }

            // 遍历下一个一级书签
            currentBookmark = currentBookmark.getNextSibling();
        }

        // 4. 保存修改（必须保存才会生效）
        doc.save(PDFDoc.e_SaveFlagNoIncremental, null);
        doc.close();
        Library.release();
    }
}

注意事项

仅对有子书签的书签生效：无Count属性的书签修改无效；
保存生效：修改后需调用doc.save()，且建议使用非增量保存（e_SaveFlagNoIncremental）；
多级书签：若需折叠 / 展开多级子书签，需递归遍历书签树。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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