在 PDF 文件中添加文本边框

本教程将指导您完成使用 Aspose.PDF for .NET 在 PDF 文件中添加文本边框的过程。提供的 C# 源代码演示了必要的步骤。

要求

在开始之前，请确保您具备以下条件：

Visual Studio 或计算机上安装的任何其他 C# 编译器。
Aspose.PDF for .NET 库。您可以从 Aspose 官方网站下载它或使用 NuGet 等包管理器来安装它。

第 1 步：设置项目

在您首选的开发环境中创建一个新的 C# 项目。
添加对 Aspose.PDF for .NET 库的引用。

第2步：导入所需的命名空间

在要添加文本边框的代码文件中，在文件顶部添加以下 using 指令：

using Aspose.Pdf;
using Aspose.Pdf.Text;

第三步：设置文档目录

在代码中，找到显示以下内容的行string dataDir = "YOUR DOCUMENT DIRECTORY";并替换"YOUR DOCUMENT DIRECTORY"以及存储文档的目录的路径。

步骤 4：创建一个新的 Document 对象

实例化一个新的Document对象，添加以下代码行：

Document pdfDocument = new Document();

步骤 5：向文档添加页面

使用以下命令将新页面添加到文档中Add的方法Pages收藏。在提供的代码中，新页面被分配给变量pdfPage.

Page pdfPage = (Page)pdfDocument.Pages.Add();

第 6 步：创建一个 TextFragment

创建一个TextFragment对象并提供所需的文本。使用设置文本片段的位置Position财产。在提供的代码中，文本设置为“主文本”并位于页面上的 (100, 600) 处。

TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);

第 7 步：设置文本属性

自定义文本属性，如字体大小、字体类型、背景颜色、前景色等。在提供的代码中，为文本片段设置字体大小、字体、背景颜色、前景色和描边颜色等属性。

textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;

第 8 步：启用文本边框

要启用文本边框，请设置DrawTextRectangleBorder文本片段的属性TextState到true.

textFragment.TextState.DrawTextRectangleBorder = true;

第9步：将TextFragment添加到页面

使用TextBuilder类来添加TextFragment反对该页面。

TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);

第10步：保存PDF文档

使用以下命令保存 PDF 文档Save的方法Document目的。指定您在步骤 3 中设置的输出文件路径。

pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");

使用 Aspose.PDF for .NET 添加文本边框的示例源代码

//文档目录的路径。
string dataDir = "YOUR DOCUMENT DIRECTORY";
//创建新文档对象
Document pdfDocument = new Document();
//获取特定页面
Page pdfPage = (Page)pdfDocument.Pages.Add();
//创建文本片段
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
//设置文本属性
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
//设置 StrokingColor 属性以在文本矩形周围绘制边框（描边）
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
//将 DrawTextRectangleBorder 属性值设置为 true
textFragment.TextState.DrawTextRectangleBorder = true;
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
//保存文档
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");

结论

您已使用 Aspose.PDF for .NET 成功向 PDF 文档添加文本边框。现在可以在指定的输出文件路径中找到生成的 PDF 文件。

常见问题解答

问：本教程的主要重点是什么？

答：本教程将指导您完成使用 Aspose.PDF for .NET 库向 PDF 文件添加文本边框的过程。提供的 C# 源代码演示了实现此目的的必要步骤。

问：本教程需要导入哪些命名空间？

A：在要添加文本边框的代码文件中，在文件开头导入以下命名空间：

using Aspose.Pdf;
using Aspose.Pdf.Text;

问：如何指定文档目录？

A：在代码中，找到行string dataDir = "YOUR DOCUMENT DIRECTORY";并替换"YOUR DOCUMENT DIRECTORY"与文档目录的实际路径。

问：如何创建 Document 对象？

答：在第 4 步中，您将实例化一个新的Document使用以下代码行对象：

Document pdfDocument = new Document();

问：如何向文档添加页面？

答：在第 5 步中，您将使用Add的方法Pages收藏：

Page pdfPage = (Page)pdfDocument.Pages.Add();

问：如何创建 TextFragment 并设置其位置？

答：在第 6 步中，您将创建一个TextFragment对象并使用以下命令设置其在页面上的位置Position财产：

TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);

问：如何自定义文本属性，包括文本边框？

答：在步骤 7 中，您将自定义各种文本属性，例如字体大小、字体类型、背景颜色、前景色和文本边框：

textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
textFragment.TextState.DrawTextRectangleBorder = true;

问：如何将 TextFragment 添加到 PDF 文档中？

答：在第 9 步中，您将使用TextBuilder类来添加TextFragment页面对象：

TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);

问：如何保存生成的 PDF 文档？

A：添加带边框的文本后，使用Save的方法Document保存 PDF 文档的对象：

pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");

问：本教程的主要内容是什么？

答：通过学习本教程，您已经成功学习了如何使用 Aspose.PDF for .NET 添加文本边框来增强 PDF 文档。这对于强调 PDF 文件中的特定文本内容特别有用。

在 PDF 文件中添加后续行缩进在 PDF 文件中添加带有底纹颜色的文本