C# 添加、修改和删除PDF书签的实例代码
有时候我们在阅读pdf文档时会遇到这样一种情况:pdf文档页数比较多,但是又没有书签,所以我们不能根据书签快速了解文档所讲解的内容,也不能点击书签快速跳转到相应的位置,而只能一页一页的翻阅,非常苦恼。相信开发人员在开发和pdf有关的应用程序时,也会有这样的功能需求,因此在这篇文章中我就介绍一下如何使用编程的方式(c#)和spire.pdf组件给pdf文档添加书签(包括添加书签到现有文档和添加子书签),以及修改和删除现有pdf文档中的指定书签。
spire.pdf组件概述
spire.pdf是一个专业的pdf组件,用于在.net应用程序中创建,编辑,处理和阅读pdf文档。支持丰富的pdf文档处理操作,如pdf文档合并/拆分、转换(如html转pdf,pdf转图片等)、打印(包括静默打印)、压缩、添加/修改/删除书签、添加注释、安全设置(包括数字签名)、创建与填充域、图片插入与提取、文本提取与高亮等。它不依赖adobe acrobat,因此运行环境无需安装adobe reader或其他类似组件。 该组件分为商业版和免费版(不是试用版)两种,一般个人使用或者操作的pdf文档不超过10页时,可以使用免费版。
关于它的安装,有很多种渠道,包括官网以及开发者最喜欢和常用的nuget方式。在visual studio的 nuget package manager console中输入以下powershell命令回车,组件的dll就会自动地引用到项目中:
pm> install-package spire.pdf
添加、修改和删除pdf书签的实现
一、添加书签
1.1 添加书签
在spire.pdf中,每个pdf文档都有一个书签列表(pdfbookmarkcollection)。我们可以通过pdfdocument对象的bookmarks属性来获取该列表,然后通过add () 方法将书签添加到列表中。
//新建pdf文档 pdfdocument pdf = new pdfdocument(); //添加页面 pdfpagebase page = pdf.pages.add(); //添加书签 pdfbookmark bookmark = pdf.bookmarks.add("第一页"); //设置书签所指向的页面和位置,(0,0)表示页面的开始位置 bookmark.destination = new pdfdestination(page); bookmark.destination.location = new pointf(0, 0); //设置书签的文本格式和颜色 bookmark.displaystyle = pdftextstyle.bold; bookmark.color = color.black; //保存文档 pdf.savetofile("bookmark2.pdf");
1.2 添加子书签
添加子书签和添加普通书签的方式基本一样,不同的是普通书签是直接添加到文档的书签列表里,而子书签则是添加到父书签的列表里。
//新建pdf文档 pdfdocument pdf = new pdfdocument(); //添加页面 pdfpagebase page = pdf.pages.add(); //添加书签 pdfbookmark bookmark = pdf.bookmarks.add("第一章 热传导"); //设置书签指向的页面和位置 bookmark.destination = new pdfdestination(page); bookmark.destination.location = new pointf(0, 0); //设置书签的文本格式和颜色 bookmark.displaystyle = pdftextstyle.bold; bookmark.color = color.seagreen; //添加子书签 pdfbookmark childbookmark = bookmark.insert(0, "1.1 热传导基本知识"); //设置子书签指向的页面和位置 childbookmark.destination = new pdfdestination(page); childbookmark.destination.location = new pointf(400, 300); //设置子书签的文本格式和颜色 childbookmark.displaystyle = pdftextstyle.regular; childbookmark.color = color.black; //保存文档 pdf.savetofile("childbookmark.pdf");
1.3 添加书签到现有文档
除了在新建的pdf文档里添加书签,我们还可以给现有的pdf文档添加书签。加载pdf文档的方法除loadfromfile以外,还有loadfromstream (从流加载),loadfromhtml(从html加载)等,可根据自己的需求选择相应的加载方式。
//加载文档 pdfdocument pdf = new pdfdocument(); pdf.loadfromfile("示例.pdf"); for (int i = 0; i < pdf.pages.count; i++) { //添加书签 pdfbookmark bookmark = pdf.bookmarks.add(string.format("第{0}章", i+1)); //设置书签指向的页面和位置 bookmark.destination = new pdfdestination(pdf.pages[i]); bookmark.destination.location = new pointf(0, 0); //设置书签的文本格式和颜色 bookmark.displaystyle = pdftextstyle.bold; bookmark.color = color.black; } //保存文档 pdf.savetofile("bookmark2.pdf");
2. 修改书签
spire.pdf支持多种书签修改方式,例如修改现有书签的内容,插入新书签到现有书签列表,插入子书签到现有书签等。这里我选取修改书签内容和插入新书签到现有书签列表进行介绍。
2.1 修改现有书签内容
//加载文档 pdfdocument pdf = new pdfdocument(); pdf.loadfromfile("bookmark2.pdf"); //获取书签列表 pdfbookmarkcollection bookmarks = pdf.bookmarks; //获取第一个书签 pdfbookmark bookmark = bookmarks[0]; //修改书签指向的页面 bookmark.destination = new pdfdestination(document.pages[1]); //修改书签的文本格式和颜色 bookmark.displaystyle = pdftextstyle.bold; bookmark.color = color.green; //修改书签的title bookmark.title = "修改"; //保存文档 pdf.savetofile("modifybookmark.pdf");
2.2 插入新书签到现有书签列表
//加载文档 pdfdocument pdf = new pdfdocument(); pdf.loadfromfile("bookmark2.pdf"); //插入新书签到指定位置(此处插入的是第三个书签的位置) pdfbookmark bookmark = pdf.bookmarks.insert(2, "新增第三章"); //设置书签所指向的页面和位置 bookmark.destination = new pdfdestination(document.pages[1]); bookmark.destination.location = new pointf(0, 300); //保存文档 pdf.savetofile("insertbookmark.pdf");
3. 删除书签
删除书签时,可以使用书签的序号,也可以使用书签的名称。这里我使用的是序号的方式。
//加载文档 pdfdocument pdf = new pdfdocument(); pdf.loadfromfile("bookmark2.pdf"); //获取书签列表 pdfbookmarkcollection bookmarks = document.bookmarks; //删除第一个书签 bookmarks.removeat(0); //保存文档 pdf.savetofile("deletebookmark.pdf");
以上博主只总结了部分操作pdf书签的功能,如果需要详细了解其他的功能,请查阅:http://e-iceblue.cn/introduce/spire-pdf-net.html.希望对大家的学习有所帮助,也希望大家多多支持。