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

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

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

مخزن:

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>

الاعتماد:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-pdf</artifactId>
    <version>22.4</version>
</dependency>

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

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة ارتباط تشعبي في PDF في Java.

// افتح المستند
Document document = new Document("input.pdf");

// احصل على مرجع الصفحة
Page page = document.getPages().get_Item(1);

// إنشاء رابط التعليق التوضيحي
LinkAnnotation link = new LinkAnnotation(page, new com.aspose.pdf.Rectangle(100, 100, 300, 300));

// إنشاء كائن حد لـ LinkAnnotation
Border border = new Border(link);

// اضبط قيمة عرض الحد على 0
border.setWidth ( 0);

// قم بتعيين حدود LinkAnnotation
link.setBorder(border);

// حدد نوع الارتباط كعنوان URI بعيد
link.setAction( new GoToURIAction("www.aspose.com"));

// أضف تعليقًا توضيحيًا للرابط إلى مجموعة التعليقات التوضيحية للصفحة الأولى من ملف PDF
page.getAnnotations().add(link);

// احفظ المستند المحدث
document.save("output.pdf");

يمكنك أيضًا الانتقال إلى ملف PDF خارجي من ملف PDF باستخدام ارتباط تشعبي. توضح الخطوات التالية كيفية إضافة ارتباط تشعبي لملف PDF خارجي في Java.

  • قم بإنشاء ملف PDF جديد أو تحميل ملف موجود باستخدام فئة مستند.
  • احصل على مرجع الصفحة حيث تريد إضافة الارتباط التشعبي من مجموعة Document.getPages().
  • قم بإنشاء كائن من فئة LinkAnnotation وضبط خصائصه.
  • استخدم طريقة LinkAnnotation.setAction() لتعيين الإجراء على كائن GoToRemoteAction الذي يحتوي على مسار إلى PDF خارجي.
  • أضف ارتباط تشعبي إلى الصفحة باستخدام طريقة Page.getAnnotations().add().
  • احفظ ملف PDF باستخدام طريقة Document.save (String).

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة ارتباط تشعبي لملف PDF خارجي في Java.

// افتح المستند
Document document = new Document("input.pdf");

// احصل على مرجع الصفحة
Page page = document.getPages().get_Item(1);

// إنشاء ارتباط تشعبي
LinkAnnotation link = new LinkAnnotation(page, new com.aspose.pdf.Rectangle(100, 100, 300, 300));
link.setColor(Color.getGreen());

// مجموعة العمل
link.setAction( new GoToRemoteAction("external.pdf", 1));

// أضف تعليقًا توضيحيًا للرابط إلى مجموعة التعليقات التوضيحية للصفحة الأولى من ملف PDF
page.getAnnotations().add(link);

// احفظ المستند المحدث
document.save("output.pdf");

في بعض الحالات ، يجب عليك التنقل من صفحة إلى أخرى داخل مستند PDF. يتم استخدام فئة LocalHyperlink للتنقل إلى صفحة معينة في ملف PDF. فيما يلي الخطوات لتحقيق ذلك.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة ارتباط تشعبي للانتقال إلى صفحة معينة في PDF.

// افتح المستند
Document document = new Document("input.pdf");

// احصل على مرجع الصفحة
Page page = document.getPages().get_Item(1);

// إنشاء مثيل TextFragment
TextFragment text = new TextFragment("link page number test to page 7");

// إنشاء مثيل ارتباط تشعبي محلي
LocalHyperlink link = new LocalHyperlink();

// تعيين الصفحة الهدف لمثيل الارتباط
link.setTargetPageNumber( 7);

// تعيين ارتباط تشعبي TextFragment
text.setHyperlink(link);

// إضافة نص إلى مجموعة فقرات الصفحة
page.getParagraphs().add(text);

// احفظ المستند المحدث
document.save("output.pdf");

يمكنك أيضًا استرداد ارتباط تشعبي من ملف PDF وتحديث خصائصه. فيما يلي خطوات إجراء هذه العملية.

  • قم بإنشاء ملف PDF جديد أو تحميل ملف موجود باستخدام فئة مستند.
  • احصل على مرجع الصفحة حيث يوجد الارتباط التشعبي من مجموعة Document.getPages().
  • استخرج LinkAnnotation الكائن المطلوب بالفهرس باستخدام طريقة Page.getAnnotations().getitem().
  • قم بتحديث الخصائص المطلوبة للارتباط التشعبي وحفظ ملف PDF باستخدام طريقة Document.save (String).

يوضح نموذج التعليمات البرمجية التالي كيفية تحديث ارتباط تشعبي في PDF باستخدام Java.

// افتح المستند
Document document = new Document("input.pdf");

// احصل على التعليق التوضيحي للرابط الأول من الصفحة الأولى من المستند
LinkAnnotation linkAnnot = (LinkAnnotation)document.getPages().get_Item(1).getAnnotations().get_Item(1);

// تغيير إجراء الارتباط وتعيين الهدف كعنوان ويب
linkAnnot.setAction(new GoToURIAction("www.aspose.com"));

// تغيير الخصائص الأخرى كما هو مطلوب

// احفظ المستند المحدث
document.save("output.pdf");

Java API لإضافة روابط تشعبية في PDF - احصل على ترخيص مجاني

يمكنك الحصول على ترخيص مؤقت مجاني من أجل استخدام Aspose.PDF لجافا دون قيود التقييم.

استنتاج

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

أنظر أيضا