PDF轉換控件Aspose.PDF for .Net使用教程(九):在PDF文件中創建、更新和提取鏈接
Aspose.PDF for .NET是一種高PDF處理和解析API,用于在跨平臺應用程序中執行文檔管理和操作任務。API可以輕松用于生成、修改、轉換、渲染、保護和打印PDF文檔,而無需使用Adobe Acrobat。此外,API還提供PDF壓縮選項,表格創建和操作,圖形和圖像功能,廣泛的超鏈接功能,印章和水印任務,擴展的安全控制和自定義字體處理。
在接下來的系列教程中,將為開發者帶來Aspose.PDF for .NET的一系列使用教程,例如進行文檔間的轉換,如何標記PDF文件,如何使用表單和圖表等等。
第三章:使用鏈接和操作
▲第一節:創建、更新和提取鏈接
在PDF文件中創建應用程序鏈接
通過將應用程序的鏈接添加到文檔中,可以鏈接到文檔中的應用程序。例如,讀者在教程中的特定點執行某個操作或創建功能豐富的文檔時,這功能非常有用。要創建應用程序鏈接:
- 創建一個Document對象。
- 獲取Page要添加鏈接的鏈接。
- LinkAnnotation使用Page和Rectangle對象創建對象。
- 使用LinkAnnotation對象設置鏈接屬性。
- 設置LaunchAction對象的Action屬性。
- 創建LaunchAction對象時,請指定要啟動的應用程序。
- 將鏈接添加到Page對象的Annotations屬性。
- 使用Document對象的Save方法保存更新的PDF。
以下代碼段顯示了如何在PDF文件中創建指向應用程序的鏈接:
//文檔目錄的路徑。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打開文檔 Document document = new Document( dataDir + "CreateApplicationLink.pdf"); //創建鏈接 Page page = document.Pages[1]; LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300)); link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green); link.Action = new LaunchAction(document, dataDir + "CreateApplicationLink.pdf"); page.Annotations.Add(link); dataDir = dataDir + "CreateApplicationLink_out.pdf"; //保存更新的文檔 document.Save(dataDir);
在PDF文件中創建PDF文檔鏈接
Aspose.PDF for .NET允許添加指向外部PDF文件的鏈接,以便可以將多個文檔鏈接在一起。要創建PDF文檔鏈接:
- 創建一個Document對象。
- 獲取Page要添加鏈接的特定內容。
- LinkAnnotation使用Page和Rectangle對象創建對象。
- 使用LinkAnnotation對象設置鏈接屬性。
- 將Action屬性設置為GoToRemoteAction對象。
- 創建GoToRemoteAction對象時,請指定應啟動的PDF文件以及應打開的頁碼。
- 將鏈接添加到Page對象的Annotations集合中。
- 使用Document對象的Save方法保存更新的PDF。
以下代碼段顯示了如何在PDF文件中創建PDF文檔鏈接:
// 文檔目錄的路徑 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打開文檔 Document document = new Document(dataDir+ "CreateDocumentLink.pdf"); //創建鏈接 Page page = document.Pages[1]; LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300)); link.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green); link.Action = new GoToRemoteAction(dataDir + "RemoveOpenAction.pdf", 1); page.Annotations.Add(link); dataDir = dataDir + "CreateDocumentLink_out.pdf"; //保存更新的文檔 document.Save(dataDir);
更新PDF文件中的鏈接
如在PDF文件中添加超鏈接中所述,LinkAnnotation該類可以在PDF文件中添加鏈接。還有一個類似的類用于從PDF文件內部獲取現有鏈接。如果需要更新現有鏈接,請使用此選項。要更新現有鏈接:
- 加載PDF文件。
- 轉到PDF文件中的特定頁面。
- 使用GoToAction對象的Destination屬性指定鏈接目標。
- 使用XYZExplicitDestination構造函數指定目標頁面。
將鏈接目標設置為同一文檔中的頁面
以下代碼段顯示如何更新PDF文件中的鏈接并將其目標設置為文檔的第二頁:
// 文檔目錄的路徑. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加載PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); // 從文檔的第一頁獲取第一個鏈接注釋 LinkAnnotation linkAnnot = (LinkAnnotation)doc.Pages[1].Annotations[1]; // 修改鏈接:更改鏈接目標 GoToAction goToAction = (GoToAction)linkAnnot.Action; //指定鏈接對象的目標 // 第一個參數是文檔對象,第二個是目標頁碼。 // 顯示相應頁面時,5ht參數是縮放系數。使用2時,頁面將以200%縮放顯示 goToAction.Destination = new Aspose.Pdf.Annotations.XYZExplicitDestination(1, 1, 2, 2); dataDir = dataDir + "PDFLINK_Modified_UpdateLinks_out.pdf"; //使用更新的鏈接保存文檔 doc.Save(dataDir);
將鏈接目標設置為Web地址
要更新超鏈接以使其指向Web地址,請實例化GoToURIAction對象并將其傳遞給LinkAnnotations Action屬性。以下代碼段顯示了如何更新PDF文件中的鏈接并將其目標設置為Web地址。
//文檔目錄的路徑。 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加載PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); //從文檔的第一頁獲取第一個鏈接注釋 LinkAnnotation linkAnnot = (LinkAnnotation)doc.Pages[1].Annotations[1]; //修改鏈接:更改鏈接操作并將目標設置為Web地址 linkAnnot.Action = new GoToURIAction("www.aspose.com"); dataDir = dataDir + "SetDestinationLink_out.pdf"; //使用更新的鏈接保存文檔 doc.Save(dataDir);
將鏈接目標設置為另一個PDF文件
以下代碼段顯示如何更新PDF文件中的鏈接并將其目標設置為另一個PDF文件。
//文檔目錄的路徑 string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加載PDF文件 Document document = new Document(dataDir + "UpdateLinks.pdf"); LinkAnnotation linkAnnot = (LinkAnnotation)document.Pages[1].Annotations[1]; GoToRemoteAction goToR = (GoToRemoteAction)linkAnnot.Action; //下一行更新目標,不要更新文件 goToR.Destination = new XYZExplicitDestination(2, 0, 0, 1.5); //下一行更新文件 goToR.File = new FileSpecification(dataDir + "input.pdf"); dataDir = dataDir + "SetTargetLink_out.pdf"; //使用更新的鏈接保存文檔 document.Save(dataDir);
更新LinkAnnotation文本顏色
鏈接注釋不包含文本,而是將文本放在注釋下的頁面內容中。因此,要更改文本的顏色,請替換頁面文本的顏色,而不是嘗試更改注釋的顏色。以下代碼段顯示了如何更新PDF文件中鏈接批注的顏色。
// 文檔目錄的路徑. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //加載PDF文件 Document doc = new Document(dataDir + "UpdateLinks.pdf"); foreach (Annotation annotation in doc.Pages[1].Annotations) { if (annotation is LinkAnnotation) { //搜索注釋下的文本 TextFragmentAbsorber ta = new TextFragmentAbsorber(); Rectangle rect = annotation.Rect; rect.LLX -= 10; rect.LLY -= 10; rect.URX += 10; rect.URY += 10; ta.TextSearchOptions = new TextSearchOptions(rect); ta.Visit(doc.Pages[1]); //更改文本的顏色. foreach (TextFragment tf in ta.TextFragments) { tf.TextState.ForegroundColor = Color.Red; } } } dataDir = dataDir + "UpdateLinkTextColor_out.pdf"; //使用更新的鏈接保存文檔 doc.Save(dataDir);
從PDF文件中提取鏈接
鏈接在PDF文件中表示為注釋,因此要提取鏈接,請提取所有LinkAnnotation對象:
- 創建一個Document對象。
- 獲取要從中提取鏈接的頁面。
- 使用AnnotationSelector類從指定頁面中提取所有LinkAnnotation對象。
- 將AnnotationSelector對象傳遞給Page對象的Accept方法。
- 使用AnnotationSelector對象的Selected屬性將所有選定的鏈接注釋添加到IList對象中。
以下代碼段顯示了如何從PDF文件中提取鏈接:
//文檔目錄的路徑. string dataDir = RunExamples.GetDataDir_AsposePdf_LinksActions(); //打開文檔 Document document = new Document(dataDir+ "ExtractLinks.pdf"); //提取動作 Page page = document.Pages[1]; AnnotationSelector selector = new AnnotationSelector(new LinkAnnotation(page, Aspose.Pdf.Rectangle.Trivial)); page.Accept(selector); IListlist = selector.Selected; Annotation annotation = (Annotation)list[0]; dataDir = dataDir + "ExtractLinks_out.pdf"; //保存更新的文檔 document.Save(dataDir);
*想要購買Aspose.PDF for .NET正版授權的朋友可以了解詳情哦~
歡迎加入ASPOSE技術交流QQ群,各類資源及時分享,技術問題交流討論!(掃描下方二維碼加入群聊)