PDF 檔案中的文字和圖像作為段落
介紹
在當今的數位世界中，PDF 是我們大多數人每天都會遇到的通用文件格式。無論是報告、電子書或商業發票，PDF 都可以讓您輕鬆地在不同平台上分享資訊。但是如果您想以程式設計方式自訂 PDF 怎麼辦？這就是 Aspose.PDF for .NET 發揮作用的地方。
先決條件
在深入研究程式碼之前，讓我們確保您擁有順利執行所需的一切：
- Aspose.PDF for .NET 函式庫：您需要安裝 Aspose.PDF for .NET。你可以下載它這裡.
- Visual Studio：任何支援 .NET 的版本都可以正常運作。
- 對 C# 的基本了解：熟悉 C# 會有所幫助，但不用擔心 — 我將引導您完成每一步！
- PDF 文件就緒：如果您想新增自訂影像，請準備好。
您還可以免費試用該庫這裡，或者如果您正在進行大型項目，請考慮購買這裡。需要更多詳細資訊嗎？查看文件這裡.
導入包
要開始使用 Aspose.PDF for .NET，您需要匯入所需的命名空間。這些命名空間可讓您的 C# 程式碼與 Aspose.PDF 功能互動。
using System.IO;
using Aspose.Pdf;
using Aspose.Pdf.Text;
using Aspose.Pdf.Facades;
using System;
很簡單，對吧？現在讓我們進入有趣的部分——創建您自己的 PDF 文件。
逐步指南：建立包含文字和內嵌影像的 PDF
讓我們將其分解為易於理解、易於遵循的步驟。想像一下你正在組裝拼圖；每一步都像是找到並放置正確的棋子。
步驟1：初始化PDF文檔
第一步是使用 Aspose.PDF 初始化一個新的 PDF 文件。本文檔將作為新增文字和圖像的基礎。
//文檔目錄的路徑。
string dataDir = "YOUR DOCUMENT DIRECTORY";
//實例化文件實例
Document doc = new Document();
這裡發生了什麼事？我們只是使用以下命令創建一個新文檔Document類別並定義要儲存 PDF 的目錄。這就像為您的傑作打開了一塊新的畫布！
第 2 步：向 PDF 新增頁面
沒有頁面的文檔沒有多大用處，對嗎？讓我們為您的文件新增一個空白頁。
//將頁面加入到 Document 實例的頁面集合中
Page page = doc.Pages.Add();
此程式碼片段將一個新頁面新增到文件的頁面集合中。可以將其視為翻開筆記本中的空白頁。
步驟 3：將文字新增為段落
接下來，我們將新增一個文字段落。您可以在此處插入訊息或標題。
//建立文字片段
TextFragment text = new TextFragment("Hello World.. ");
//將文字片段加入到 Page 物件的段落集合中
page.Paragraphs.Add(text);
在這裡，我們創建一個TextFragment物件來保存文字“Hello World..”，然後將其作為段落新增到頁面中。這就像在 PDF 文件中寫下第一句話一樣。
步驟 4：新增影像作為內嵌段落
現在我們已經有了文本，讓我們透過添加圖像作為內聯段落來使事情變得有趣。內嵌段落僅表示圖像將出現在文字之後，就像圖像在 Word 文件中的顯示方式一樣。
//建立圖像實例
Aspose.Pdf.Image image = new Aspose.Pdf.Image();
//將圖像設定為內聯段落，以便它出現在
//上一段物件（TextFragment）
image.IsInLineParagraph = true;
//指定影像檔案路徑
image.File = dataDir + "aspose-logo.jpg";
在此程式碼片段中，我們建立一個Image對象，告訴它與文字內聯對齊，並指定圖像檔案的路徑。這相當於將圖像貼到文件中的句子後面。您可以將“aspose-logo.jpg”替換為您想要的圖片。
第 5 步：設定圖像大小（可選）
想要調整影像大小嗎？沒問題。 Aspose.PDF 讓您可以選擇在將影像新增至文件之前調整影像的高度和寬度。
//設定影像高度（可選）
image.FixHeight = 30;
//設定圖像寬度（可選）
image.FixWidth = 100;
此部分是可選的，但它可以幫助您控制圖像在 PDF 中顯示的大小。這就像在列印照片之前調整照片大小一樣。
第 6 步：將圖像加入到段落集合中
我們已經準備好了圖像。現在讓我們將其作為內聯段落插入到文件中。
//將圖像加入頁面物件的段落集合中
page.Paragraphs.Add(image);
此行將圖像新增至段落集合中的文字後面。這就像在文字編輯器中點擊“插入圖像”按鈕一樣。
第 7 步：新增另一個內嵌文字段落
如果您想在圖像後面添加更多文字怎麼辦？讓我們透過插入另一個內嵌文字片段來做到這一點。
//使用不同的內容重新初始化 TextFragment 對象
text = new TextFragment(" Hello Again..");
//將 TextFragment 設定為內嵌段落
text.IsInLineParagraph = true;
//將新建立的 TextFragment 加入到頁面的段落集合中
page.Paragraphs.Add(text);
我們正在重複使用TextFragment此處使用新文字（“Hello Again..”）物件並將其內嵌插入圖像後面。這使您的 PDF 具有流暢、有凝聚力的外觀。
步驟 8：儲存 PDF 文檔
我們快完成了！現在，讓我們將文件儲存到您指定的目錄中。
dataDir = dataDir + "TextAndImageAsParagraph_out.pdf";
doc.Save(dataDir);
Console.WriteLine("\nText and image added successfully as inline paragraphs.\nFile saved at " + dataDir);
最後一步將文件保存在您的目錄中，名稱為「TextAndImageAsParagraph_out.pdf」。恭喜您 - 您已經建立了包含文字和內嵌圖像的 PDF！
結論
現在您已經完成了，使用 Aspose.PDF for .NET 建立包含文字和圖像作為內聯段落的 PDF 就像執行以下步驟一樣簡單。只需幾行程式碼，您就可以為 PDF 檔案添加動態內容，使它們更具視覺吸引力和專業性。無論是商業報告還是電子書，控制 PDF 的佈局都可以帶來巨大的改變。
常見問題解答
我可以添加多個圖像作為內嵌段落嗎？
是的，您可以透過建立單獨的影像來新增多個影像Image物件並將它們新增至段落集合中。
我可以控制 PDF 中文字和圖像的位置嗎？
是的，使用邊距等屬性，您可以控製文字和圖像的精確位置。
Aspose.PDF for .NET 是免費的嗎？
我可以在文字中添加超連結嗎？
是的，Aspose.PDF 允許您在文字片段中新增超連結。檢查文件了解更多詳情。
我可以自訂文字的字體和樣式嗎？
絕對地！您可以輕鬆自訂文字片段的字體、顏色和其他樣式屬性。
