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

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

سيتم تناول الموضوعات التالية في هذه المقالة:

Java API لإضافة الحواشي السفلية والتعليقات الختامية في PDF

لإضافة الحواشي السفلية والتعليقات الختامية إلى مستند PDF ، سنستخدم Aspose.PDF for Java API. يتيح لنا إنشاء المستندات المدعومة وتعديلها وتحويلها وتقديمها وتأمينها وطباعتها دون استخدام Adobe Acrobat. يرجى إما تنزيل JAR الخاص بواجهة برمجة التطبيقات أو إضافة تكوين pom.xml التالي في تطبيق Java المستند إلى 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.1</version>
</dependency>

أضف الحواشي السفلية إلى ملف PDF باستخدام Java

يمكننا إضافة الحواشي السفلية في نهاية الصفحة في مستند PDF باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة Document.
  2. بعد ذلك ، أضف صفحة إلى مجموعة الصفحات من المستند.
  3. ثم قم بإنشاء TextFragment.
  4. بعد ذلك ، قم بتعيين قيمة الحاشية السفلية لكائن TextFragment.
  5. ثم أضف TextFragment إلى مجموعة الفقرات
  6. اختياريًا ، كرر الخطوات المذكورة أعلاه لإضافة المزيد من TextFragments لقيم حاشية سفلية متعددة.
  7. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الكود هذا كيفية إضافة الحواشي السفلية إلى مستند PDF.
// قم بإنشاء مثيل من المستند
Document document = new Document();

// أضف صفحة إلى مجموعة صفحات PDF
Page page = document.getPages().add();

// قم بإنشاء TextFragment
TextFragment text = new TextFragment("Hello World");

// قم بتعيين قيمة الحاشية السفلية لـ TextFragment
text.setFootNote(new Note("foot note for Hello World!"));

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

// قم بإنشاء جزء نصي آخر
text = new TextFragment("Aspose.Pdf for Java");

// تعيين حاشية سفلية لجزء النص الثاني
text.setFootNote(new Note("foot note for second text fragment!"));

// أضف جزء النص الثاني إلى مجموعة فقرات ملف PDF
page.getParagraphs().add(text);

// احفظ المستند
document.save("C:\\Files\\PDF\\sample_footnote.pdf");
أضف الحواشي السفلية إلى ملف PDF باستخدام Java.

أضف الحواشي السفلية إلى ملف PDF باستخدام Java.

أضف صورة إلى الحاشية السفلية في PDF

يمكننا إضافة صورة في الحواشي السفلية لمستند PDF باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة Document.
  2. بعد ذلك ، أضف صفحة إلى مجموعة الصفحات من المستند.
  3. ثم قم بإنشاء TextFragment.
  4. بعد ذلك ، قم بتعيين قيمة الحاشية السفلية لكائن TextFragment.
  5. ثم قم بإضافة صورة إلى كائن TextFragment.
  6. بعد ذلك ، أضف جزء نص إلى مجموعة فقرات
  7. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الكود هذا كيفية إدراج صورة في الحواشي السفلية.
// قم بإنشاء مثيل من المستند
Document document = new Document();

// أضف صفحة إلى مجموعة صفحات PDF
Page page = document.getPages().add();

// قم بإنشاء TextFragment
TextFragment text = new TextFragment("Hello World");

// قم بتعيين قيمة الحاشية السفلية لـ TextFragment
text.setFootNote(new Note());

// إضافة صورة
Image image = new Image();
image.setFile("C:\\Files\\PDF\\aspose_logo.jpg");
image.setFixHeight(20);
text.getFootNote().getParagraphs().add(image);

// قم بإنشاء جزء نصي
TextFragment footNote = new TextFragment(" foot note for Hello World!");
footNote.getTextState().setFontSize(20);
footNote.setInLineParagraph(true);
text.getFootNote().getParagraphs().add(footNote);

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

// احفظ المستند
document.save("C:\\Files\\PDF\\image_footnote.pdf");
Add an Image to Footnote in PDF.

قم بإدراج جدول في الحاشية السفلية في PDF

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

  1. أولاً ، قم بإنشاء مثيل لفئة Document.
  2. بعد ذلك ، أضف صفحة إلى مجموعة الصفحات من المستند.
  3. ثم قم بإنشاء TextFragment.
  4. بعد ذلك ، قم بتعيين قيمة الحاشية السفلية لكائن TextFragment.
  5. ثم أضف جدول إلى كائن TextFragment.
  6. بعد ذلك ، أضف جزء نص إلى مجموعة فقرات
  7. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الكود هذا كيفية إضافة جدول إلى الحواشي السفلية.
// إنشاء مثيل المستند
Document document = new Document();

// أضف صفحة إلى مجموعة صفحات PDF
Page page = document.getPages().add();

// إنشاء مثيل TextFragment
TextFragment text = new TextFragment("Hello World");

// قم بتعيين قيمة الحاشية السفلية لـ TextFragment
text.setFootNote(new Note());

// إدراج الجدول
Table table = new Table();
table.getRows().add().getCells().add().getParagraphs().add(new TextFragment("Row 1 Cell 1"));
table.getRows().get_Item(0).getCells().add().getParagraphs().add(new TextFragment("Row 1 Cell 2"));
table.getRows().add().getCells().add().getParagraphs().add(new TextFragment("Row 2 Cell 1"));
table.getRows().get_Item(1).getCells().add().getParagraphs().add(new TextFragment("Row 2 Cell 2"));
text.getFootNote().getParagraphs().add(table);

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

// احفظ المستند
document.save("C:\\Files\\PDF\\Table_footnote.pdf");
قم بإدراج جدول في الحاشية السفلية في PDF.

قم بإدراج جدول في الحاشية السفلية في PDF.

تخصيص تسمية الحاشية السفلية ونمط الخط باستخدام Java

يمكننا تخصيص تسمية الحواشي السفلية ونمط خط الحاشية السفلية في مستند PDF باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة Document.
  2. بعد ذلك ، أضف صفحة إلى مجموعة الصفحات من المستند.
  3. بعد ذلك ، قم بتهيئة كائن GraphInfo لتخصيص نمط الخط.
  4. قم بتعيين خصائص كائن GraphInfo مثل LineWidth و Color و DashArray وما إلى ذلك.
  5. بعد ذلك ، قم بإنشاء TextFragment.
  6. ثم قم بتعيين حاشية سفلية قيمة لكائن TextFragment.
  7. بعد ذلك ، قم بتهيئة كائن TextState وقم بتعيين خصائص مختلفة ، على سبيل المثال ، ForegroundColor ، و FontStyle ، إلخ.
  8. بعد ذلك ، أضف جزء نص إلى مجموعة فقرات
  9. اختياريًا ، كرر الخطوات المذكورة أعلاه لإضافة المزيد من TextFragments لقيم حاشية سفلية متعددة.
  10. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الكود هذا كيفية تخصيص تسمية الحواشي السفلية ونمط الخط.
// إنشاء مثيل المستند
Document document = new Document();

// أضف صفحة إلى مجموعة صفحات PDF
Page page = document.getPages().add();

// تخصيص نمط الخط
// إنشاء كائن GraphInfo
GraphInfo graph = new GraphInfo();

// قم بتعيين عرض الخط على أنه 2
graph.setLineWidth(2);

// اضبط لون كائن الرسم البياني
graph.setColor(Color.getRed());

// تعيين قيمة مجموعة الشرطة على 3
graph.setDashArray(new int[] { 3 });

// قم بتعيين قيمة مرحلة الشرطة على أنها 1
graph.setDashPhase(1);

// تعيين نمط خط الحاشية السفلية للصفحة كرسم بياني
page.setNoteLineStyle(graph);

// إنشاء مثيل TextFragment
TextFragment text = new TextFragment("Hello World");

// قم بتعيين قيمة الحاشية السفلية لـ TextFragment
text.setFootNote(new Note("foot note for Hello World!"));

// تخصيص التسمية
text.getFootNote().setText("FOOTNOTE-1");
TextState ts = new TextState();
ts.setForegroundColor(Color.getBlue());
ts.setFontStyle(FontStyles.Italic);
text.getFootNote().setTextState(ts);

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

// قم بإنشاء جزء نصي آخر
text = new TextFragment("Aspose.Pdf for Java");

// تعيين حاشية سفلية لجزء النص الثاني
text.setFootNote(new Note("foot note for second text fragment!"));

// أضف جزء النص الثاني إلى مجموعة فقرات ملف PDF
page.getParagraphs().add(text);

// احفظ المستند
document.save("C:\\Files\\PDF\\customize_footnote.pdf");
تخصيص تسمية الحاشية السفلية ونمط الخط باستخدام Java.

تخصيص تسمية الحاشية السفلية ونمط الخط باستخدام Java.

أضف الحواشي السفلية إلى ملف PDF الحالي باستخدام Java

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

  1. أولاً ، قم بتحميل ملف PDF باستخدام فئة المستند.
  2. بعد ذلك ، احصل على صفحة معينة بفهرسها.
  3. بعد ذلك ، قم بإنشاء كائن TextFragmentAbsorber باستخدام عبارة البحث كمدخلات.
  4. بعد ذلك ، قم باستدعاء الأسلوب Accept () للبحث عن عبارة الإدخال من الصفحة.
  5. بعد ذلك ، احصل على أول ظهور لعبارة البحث من TextFragmentCollection.
  6. بعد ذلك ، قم بإنشاء TextFragment فارغ وتعيين موضعه على الصفحة.
  7. أيضًا ، قم بتعيين قيمة الحاشية السفلية لكائن TextFragment.
  8. بعد ذلك ، أضف جزء نص إلى مجموعة فقرات
  9. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الكود هذا كيفية إضافة الحواشي السفلية إلى مستند PDF موجود.
// قم بتحميل مستند PDF موجود
Document document = new Document("C:\\Files\\PDF\\sample.pdf");

// قم بإنشاء كائن TextAbsorber للعثور على جميع مثيلات العبارة النصية
TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber("Class");

// احصل على صفحة معينة
Page page = document.getPages().get_Item(2);

// قبول الممتص للصفحة الثانية من الوثيقة
page.accept(textFragmentAbsorber);

// احصل على أجزاء النص المستخرجة في المجموعة
TextFragmentCollection textFragmentCollection = textFragmentAbsorber.getTextFragments();

// الحصول على أول ظهور للنص
TextFragment textFragment = textFragmentCollection.get_Item(1);

// قم بإنشاء جزء نص فارغ
TextFragment text = new TextFragment("");

// تعيين الموقف
Position position = textFragment.getPosition();
position = new Position(position.getXIndent() + 26, position.getYIndent());
text.setPosition(position);

// قم بتعيين قيمة الحاشية السفلية لـ TextFragment
text.setFootNote(new Note("This is example footnote added in an existing PDF!"));

// أضف جزء النص الثاني إلى مجموعة فقرات ملف PDF
page.getParagraphs().add(text);

// احفظ المستند
document.save("C:\\Files\\PDF\\Text_Added.pdf");
إضافة الحواشي السفلية إلى PDF الموجود باستخدام جافا

أضف الحواشي السفلية إلى ملف PDF الحالي باستخدام Java.

أضف التعليقات الختامية إلى PDF باستخدام Java

يمكننا أيضًا إضافة تعليقات ختامية في نهاية مستند PDF باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة Document.
  2. بعد ذلك ، أضف صفحة إلى مجموعة الصفحات من المستند.
  3. ثم قم بإنشاء TextFragment.
  4. بعد ذلك ، قم بتعيين قيمة Endnote لكائن TextFragment.
  5. اختياريًا ، قم بتعيين تسمية مخصصة للتعليق الختامي.
  6. بعد ذلك ، أضف جزء نص إلى مجموعة فقرات.
  7. أخيرًا ، احفظ ملف PDF باستخدام طريقة Document.Save (). يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال الرمز هذا كيفية إضافة التعليقات الختامية إلى مستند PDF.
// قم بإنشاء مثيل المستند
Document doc = new Document();

// أضف صفحة إلى مجموعة صفحات PDF
Page page = doc.getPages().add();

// إنشاء مثيل TextFragment
TextFragment text = new TextFragment("Hello World");

// قم بتعيين قيمة FootNote لـ TextFragment
text.setEndNote(new Note("sample End note"));

// حدد تسمية مخصصة لـ FootNote
text.getEndNote().setText(" Aspose(2015)");

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

// احفظ ملف PDF
doc.save("C:\\Files\\PDF\\EndNote.pdf");

احصل على ترخيص API مجاني

يمكنك تجربة واجهة برمجة التطبيقات بدون قيود التقييم من خلال طلب ترخيص مؤقت مجاني.

استنتاج

في هذه المقالة ، تعلمنا كيفية:

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

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

أنظر أيضا