قم بإضافة أو تحديث الارتباطات التشعبية في PDF باستخدام C# .NET

PDF هو تنسيق مستند غني بالميزات يدعم مجموعة من العناصر بما في ذلك التعليقات التوضيحية والوسائط والنماذج وما إلى ذلك. يعد الارتباط التشعبي عنصرًا مهمًا يتم استخدامه للتنقل داخل ملف PDF ، من ملف PDF إلى آخر ، إلى صفحة ويب ، إلخ. أثناء إنشاء مستندات PDF برمجيًا ، قد تحتاج غالبًا إلى إدراج ارتباطات تشعبية. وفقًا لذلك ، ستتعلم في هذه المقالة كيفية إضافة الارتباطات التشعبية وتحديثها في ملفات PDF في C# .NET.

لمعالجة الارتباطات التشعبية في ملفات PDF ، سنستخدم Aspose.PDF for .NET. إنها واجهة برمجة تطبيقات شائعة تتيح لك إنشاء ملفات PDF ومعالجتها وتحويلها من داخل تطبيقات .NET. يمكنك تنزيل ثنائيات API أو تثبيتها باستخدام NuGet.

PM> Install-Package Aspose.PDF

فيما يلي خطوات إضافة ارتباط تشعبي إلى ملف PDF في C#.

  • قم بإنشاء ملف PDF جديد أو تحميل ملف موجود باستخدام فئة مستند.
  • احصل على مرجع للصفحة حيث تريد إضافة ارتباط تشعبي من مجموعة Document.Pages.
  • قم بإنشاء كائن من فئة LinkAnnotation وضبط خصائصه.
  • قم بتهيئة خاصية LinkAnnotation.Action إلى كائن GoToURIAction الذي يحتوي على عنوان URL.
  • أضف ارتباطًا إلى مجموعة 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 خارجي من ملف PDF واحد باستخدام ارتباط تشعبي. توضح الخطوات التالية كيفية إضافة ارتباط تشعبي إلى ملف PDF خارجي في C#.

  • قم بإنشاء ملف PDF جديد أو تحميل ملف موجود باستخدام فئة مستند.
  • احصل على مرجع للصفحة حيث تريد إضافة ارتباط تشعبي من مجموعة 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 = 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 وتحديث خصائصه. فيما يلي خطوات إجراء هذه العملية.

  • قم بتحميل ملف 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 باستخدام التوثيق. في حال كان لديك أي أسئلة أو استفسارات ، يمكنك الاتصال بنا عبر المنتدى.

أنظر أيضا