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

福昕PDF SDK 软件开发工具包 | 福昕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）；
多级书签：若需折叠 / 展开多级子书签，需递归遍历书签树。

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

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

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

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

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

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

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

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

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

福昕高级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格式实现在线编辑