PDF הוא פורמט מסמך עשיר בתכונות התומך במגוון אלמנטים כולל הערות, מדיה, טפסים וכו’. היפר-קישור הוא רכיב חשוב המשמש לנווט בתוך ה-PDF, מ-PDF אחד לאחר, ל-PDF. דף אינטרנט וכו’ בזמן יצירת מסמכי ה-PDF באופן תוכנתי, ייתכן שתצטרך לעתים קרובות להוסיף היפר-קישורים. בהתאם לכך, במאמר זה תלמדו כיצד להוסיף ולעדכן היפר-קישורים בקבצי PDF ב-C# .NET.
- NET API להוספת היפר-קישורים ב-PDF
- הוסף היפר-קישור ב-PDF
- הוסף היפר-קישור ל-PDF חיצוני
- הוסף היפר-קישור לדף מסוים
- עדכן היפר-קישור ב-PDF
C# .NET API להוספה או עדכון של היפר-קישורים ב-PDF
כדי לתפעל היפר-קישורים בקובצי PDF, נשתמש ב-Aspose.PDF for .NET. זהו API פופולרי המאפשר לך ליצור, לעבד ולהמיר קבצי PDF מתוך יישומי NET. אתה יכול להוריד את הקבצים הבינאריים של ה-API או להתקין אותו באמצעות NuGet.
PM> Install-Package Aspose.PDF
הוסף היפר-קישור ב-PDF ב-C#
להלן השלבים להוספת היפר-קישור לקובץ PDF ב-C#.
- צור PDF חדש או טען קובץ קיים באמצעות המחלקה Document.
- קבל הפניה לדף שבו ברצונך להוסיף היפר-קישור מאוסף Document.Pages.
- צור אובייקט במחלקה LinkAnnotation והגדר את המאפיינים שלו.
- אתחול המאפיין LinkAnnotation.Action לאובייקט GoToURIAction המכיל כתובת אתר.
- הוסף קישור לאוסף Page.Annotations.
- שמור PDF בשיטת Document.Save(String).
דוגמת הקוד הבאה מראה כיצד להוסיף היפר-קישור ב-PDF ב-C#.
// פתח את המסמך
Document document = new Document("input.pdf");
// קבל הפניה לדף
var page = document.Pages[1];
// צור אובייקט הערת קישור
LinkAnnotation link = new LinkAnnotation(page, new Aspose.Pdf.Rectangle(100, 100, 300, 300));
// צור אובייקט גבול עבור LinkAnnotation
Border border = new Border(link);
// הגדר את ערך רוחב הגבול כ-0
border.Width = 0;
// הגדר את הגבול עבור LinkAnnotation
link.Border = border;
// ציין את סוג הקישור כ-URI מרוחק
link.Action = new GoToURIAction("www.aspose.com");
// הוסף הערת קישור לאוסף ההערות של העמוד הראשון של קובץ PDF
page.Annotations.Add(link);
// שמור מסמך מעודכן
document.Save("output.pdf");
הוסף היפר-קישור לקובץ PDF חיצוני ב-C#
אתה יכול גם לנווט לקובץ PDF חיצוני מ-PDF אחד באמצעות היפר-קישור. השלבים הבאים מדגימים כיצד להוסיף היפר-קישור לקובץ PDF חיצוני ב-C#.
- צור PDF חדש או טען קובץ קיים באמצעות המחלקה Document.
- קבל הפניה לדף שבו ברצונך להוסיף היפר-קישור מאוסף Document.Pages.
- צור אובייקט במחלקה LinkAnnotation והגדר את המאפיינים שלו.
- אתחול המאפיין LinkAnnotation.Action לאובייקט GoToRemoteAction המכיל נתיב ל-PDF חיצוני.
- הוסף קישור לאוסף Page.Annotations.
- שמור מסמך בשיטת Document.Save(String).
דוגמת הקוד הבאה מראה כיצד להוסיף היפר-קישור ל-PDF חיצוני ב-C#.
// פתח את המסמך
Document document = new Document("input.pdf");
// קבל הפניה לדף
var 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("external.pdf", 1);
// הוסף היפר קישור לעמוד
page.Annotations.Add(link);
// שמור מסמך מעודכן
document.Save("output.pdf");
הוסף היפר-קישור לדף PDF מסוים
במקרים מסוימים, עליך לנווט מעמוד אחד לאחר בתוך מסמך PDF. המחלקה LocalHyperlink משמשת כדי לנווט לדף המסוים ב-PDF. להלן השלבים להשגת זאת.
- צור PDF חדש או טען קובץ קיים באמצעות המחלקה Document.
- קבל הפניה לדף שבו ברצונך להוסיף היפר-קישור מאוסף Document.Pages.
- צור מופע של TextFragment כדי להגדיר טקסט של ההיפר-קישור.
- צור מופע של מחלקה LocalHyperlink והגדר את המאפיין LocalHyperlink.TargetPageNumber למספר העמוד הרצוי.
- הקצה אובייקט LocalHyperlink למאפיין TextFragment.Hyperlink.
- הוסף טקסט לדף בשיטת Page.Paragraphs.Add(TextFragment).
- שמור PDF בשיטת Document.Save(String).
דוגמת הקוד הבאה מראה כיצד להוסיף היפר-קישור כדי לנווט לדף מסוים ב-PDF.
// פתח את המסמך
Document document = new Document("input.pdf");
// קבל הפניה לדף
var page = document.Pages[1];
// צור מופע TextFragment
Aspose.Pdf.Text.TextFragment text = new Aspose.Pdf.Text.TextFragment("link page number test to page 7");
// צור מופע היפר-קישור מקומי
Aspose.Pdf.LocalHyperlink link = new Aspose.Pdf.LocalHyperlink();
// הגדר דף יעד למופע קישור
link.TargetPageNumber = 7;
// הגדר היפר-קישור TextFragment
text.Hyperlink = link;
// הוסף טקסט לאוסף פסקאות של עמוד
page.Paragraphs.Add(text);
// שמור מסמך מעודכן
document.Save("output.pdf");
עדכן היפר-קישור ב-PDF באמצעות C#
ניתן גם לאחזר היפר-קישור בקובץ PDF ולעדכן את המאפיינים שלו. להלן השלבים לביצוע פעולה זו.
- טען את קובץ ה-PDF באמצעות מחלקה מסמך.
- קבל הפניה לדף שבו נמצא ההיפר-קישור מאוסף Document.Pages.
- חלץ את האובייקט הרצוי LinkAnnotation מאוסף Page.Annotations לפי אינדקס.
- עדכן את המאפיינים הנדרשים ושמור PDF באמצעות שיטת Document.Save(String).
דוגמת הקוד הבאה מראה כיצד לעדכן היפר-קישור ב-PDF באמצעות C#.
// פתח את המסמך
Document document = new Document("input.pdf");];
// קבל את הערת הקישור הראשונה מהעמוד הראשון של המסמך
LinkAnnotation linkAnnot = (LinkAnnotation)document.Pages[1].Annotations[1];
// שנה פעולת קישור והגדר יעד ככתובת אינטרנט
linkAnnot.Action = new GoToURIAction("www.aspose.com");
// שנה מאפיינים אחרים לפי הצורך
// שמור מסמך מעודכן
document.Save("output.pdf");
קבל רישיון חינם
אתה יכול לקבל רישיון זמני בחינם על מנת להשתמש ב-Aspose.PDF עבור .NET ללא מגבלות הערכה.
סיכום
במאמר זה, למדת כיצד להוסיף סוגים שונים של היפר-קישורים בקבצי PDF באמצעות C#. יתר על כן, ראית כיצד לאחזר את ההיפר-קישורים מקבצי PDF קיימים ולעדכן את המאפיינים שלהם באופן תוכנתי. בנוסף, אתה יכול לחקור עוד על .NET PDF API באמצעות תיעוד. במקרה שיש לך שאלות או שאילתות כלשהן, תוכל ליצור איתנו קשר דרך הפורום שלנו.