使用C#代码展开或折叠 PDF 书签

原创

用户12401097

发布于 2026-08-12 11:52:35

1070

在 PDF 文档中，展开或折叠书签功能可以帮助用户更有条理地浏览和定位内容。展开书签后，用户可以一次性查看完整的书签层级结构，更直观地了解文档组织方式；而折叠书签则可以隐藏多余的层级信息，让用户专注于当前需要查看的部分，避免受到过多目录内容的干扰。

本文将介绍如何在 C# 中展开或折叠 PDF 书签，帮助开发人员实现更加灵活的 PDF 导航体验。

添加 PDF 处理组件

首先，需要在 .NET 项目中引入用于处理 PDF 文档的相关组件。可以通过下载对应的 DLL 文件，或使用 NuGet 包管理器安装所需程序集。完成引用配置后，即可在项目中实现 PDF 文档的读取、编辑和管理等操作。

PM> Install-Package Spire.PDF

使用 C# 展开或折叠 PDF 中的指定书签

在 C# 中，开发人员可以通过设置书签的展开状态，实现对 PDF 文档中特定书签的展开或折叠控制。该功能可以帮助优化文档导航结构，让用户根据需要查看不同层级的内容。

以下是在 C# 中展开或折叠 PDF 指定书签的步骤：

创建一个 PdfDocument 对象。
使用 PdfDocument.LoadFromFile() 方法加载 PDF 文件。
通过 PdfDocument.Bookmarks[] 属性获取 PDF 文件中的指定书签。
将 PdfBookmark.ExpandBookmark 属性设置为 true 以展开书签；设置为 false 则折叠书签。
使用 PdfDocument.SaveToFile() 方法保存修改后的 PDF 文件。

完整示例代码如下：

using Spire.Pdf;
using Spire.Pdf.Bookmarks;

namespace ExpandOrCollapseABookmark
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个 PdfDocument 对象
            PdfDocument pdf = new PdfDocument();

            // 加载 PDF 文件
            pdf.LoadFromFile("AnnualReport.pdf");

            // 获取指定的书签
            PdfBookmark bookmarks = pdf.Bookmarks[3];

            // 展开书签
            bookmarks.ExpandBookmark = true;

            // 折叠书签
            // bookmarks.ExpandBookmark = false;

            // 保存结果文件
            pdf.SaveToFile("ExpandSpecifiedBookmark.pdf");
        }
    }
}

使用 C# 展开或折叠 PDF 中的所有书签

在 C# 中，开发人员可以遍历 PDF 文件中的所有书签，并通过设置书签的展开状态，实现批量展开或折叠文档目录。该功能可以帮助用户快速调整 PDF 的导航显示方式，优化文档浏览体验。

以下是在 C# 中展开或折叠 PDF 所有书签的步骤：

创建一个 PdfDocument 对象。
使用 PdfDocument.LoadFromFile() 方法加载 PDF 文件。
遍历 PDF 文件中的所有书签。
将 PdfBookmark.ExpandBookmark 属性设置为 true 以展开所有书签；设置为 false 则折叠所有书签。
使用 PdfDocument.SaveToFile() 方法保存修改后的 PDF 文件。

完整示例代码如下：

using Spire.Pdf;
using Spire.Pdf.Bookmarks;

namespace ExpandOrCollapsePDFBookmarks
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个 PdfDocument 对象
            PdfDocument pdf = new PdfDocument();

            // 加载 PDF 文件
            pdf.LoadFromFile("AnnualReport.pdf");

            // 遍历所有书签并展开
            foreach (PdfBookmark bookmark in pdf.Bookmarks)
            {
                bookmark.ExpandBookmark = true;
            }

            // 保存结果文件
            pdf.SaveToFile("ExpandAllBookmarks.pdf");
        }
    }
}

总结

PDF 书签可以帮助用户快速定位文档内容，而通过控制书签的展开或折叠状态，可以进一步优化文档的导航体验。在 C# 中，开发人员可以通过修改书签属性，实现对单个书签或全部书签显示状态的灵活管理。

本文介绍了如何在 C# 中加载 PDF 文件，并通过遍历书签或指定书签的方式设置其展开或折叠状态。该方法适用于需要调整 PDF 目录结构、改善文档可读性以及优化用户浏览体验的应用场景。通过合理管理书签显示方式，可以让复杂的 PDF 文档更加易于查看和导航。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

pdf