Add Footnotes and Endnotes in PDF using Java.

یادداشت پا یک یادداشت یا متنی است که در پایین یک صفحه خاص قرار دارد، در حالی که یادداشت انتهایی یادداشتی است که در انتهای یک سند قرار می‌گیرد. ما معمولاً از یادداشت‌های پا یا یادداشت‌های انتهایی برای ارجاعات، توضیحات یا نظرات در سند استفاده می‌کنیم. ما می‌توانیم به صورت برنامه‌نویسی یادداشت‌های پا/یادداشت‌های انتهایی را به سند PDF اضافه کنیم. در این مقاله، یاد خواهیم گرفت که چگونه یادداشت‌های پا و یادداشت‌های انتهایی را در اسناد PDF با استفاده از Java اضافه کنیم.

موضوعات زیر در این مقاله پوشش داده خواهند شد:

API Java برای افزودن پاورقی و پایان‌نامه‌ها در PDF

برای افزودن پاورقی و یادداشت پایانی به یک PDF سند، از Aspose.PDF for Java API استفاده خواهیم کرد. این API به ما اجازه می‌دهد تا اسناد پشتیبانی‌شده را بدون استفاده از Adobe Acrobat تولید، ویرایش، تبدیل، رندر، تأمین امنیت و چاپ کنیم. لطفاً یکی از گزینه‌های زیر را انجام دهید: download JAR API را دانلود کنید یا فقط پیکربندی 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. Firstly, create an instance of the Document class.
  2. Next, add a Page to the PagesCollection of the document.
  3. سپس، یک TextFragment ایجاد کنید.
  4. سپس مقدار Footnote را برای شیء TextFragment تنظیم کنید.
  5. سپس، TextFragment را به مجموعه Paragraphs اضافه کنید
  6. به طور اختیاری، مراحل بالا را تکرار کنید تا TextFragment های بیشتری برای مقادیر Footnote متعدد اضافه کنید.
  7. سرانجام، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یادداشت‌های پایینی را به یک سند PDF با استفاده از Java اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه یادداشت‌های پایینی به یک سند PDF اضافه کنیم.
// یک نمونه از سند ایجاد کنید
Document document = new Document();

// صفحه را به مجموعه صفحات PDF اضافه کنید
Page page = document.getPages().add();

// Create a TextFragment
TextFragment text = new TextFragment("Hello World");

// مقدار پاورقی را برای TextFragment تنظیم کنید
text.setFootNote(new Note("foot note for Hello World!"));

// مجموعه متنFragment را به مجموعه پاراگراف های صفحه اول سند اضافه کنید
page.getParagraphs().add(text);

// Create another TextFragment
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");
Add Footnotes to a PDF using Java.

Add Footnotes to a PDF using Java.

یک تصویر به یادداشت پایینی در PDF اضافه کنید

ما می‌توانیم یک تصویر را در یادداشت‌های پای یک سند PDF با دنبال کردن مراحل زیر اضافه کنیم:

  1. Firstly, create an instance of the Document class.
  2. Next, add a Page to the PagesCollection of the document.
  3. سپس، یک TextFragment ایجاد کنید.
  4. سپس مقدار Footnote را برای شیء TextFragment تنظیم کنید.
  5. سپس، یک تصویر به شیء TextFragment اضافه کنید.
  6. After that, add TextFragment to Paragraphs collection
  7. سرانجام، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان یک تصویر را در پاورقی‌های یک سند PDF با استفاده از Java اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه تصویری را به پاورقی‌ها اضافه کنید.
// یک مورد از Document ایجاد کنید
Document document = new Document();

// صفحه را به مجموعه صفحات PDF اضافه کنید
Page page = document.getPages().add();

// Create a TextFragment
TextFragment text = new TextFragment("Hello World");

// مقدار یادداشت پایینی را برای TextFragment تنظیم کنید
text.setFootNote(new Note());

// Add image
Image image = new Image();
image.setFile("C:\\Files\\PDF\\aspose_logo.jpg");
image.setFixHeight(20);
text.getFootNote().getParagraphs().add(image);

// Create a text fragment
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.

Add an Image to Footnote in PDF.

قرار دادن یک جدول در پاورقی در PDF

ما می‌توانیم همچنین یک جدول را در پاورقی‌های یک سند PDF با دنبال کردن مراحل زیر اضافه کنیم:

  1. Firstly, create an instance of the Document class.
  2. Next, add a Page to the PagesCollection of the document.
  3. سپس، یک TextFragment ایجاد کنید.
  4. سپس مقدار Footnote را برای شیء TextFragment تنظیم کنید.
  5. سپس، یک table به شیء TextFragment اضافه کنید.
  6. After that, add TextFragment to Paragraphs collection
  7. سرانجام، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان یک جدول را در پاورقی‌های یک سند PDF با استفاده از Java اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان جدول را به پاورقی‌ها افزود.
// Create Document instance
Document document = new Document();

// صفحه را به مجموعه صفحات PDF اضافه کنید
Page page = document.getPages().add();

// ایجاد نمونه TextFragment
TextFragment text = new TextFragment("Hello World");

// مقدار پاورقی را برای TextFragment تنظیم کنید
text.setFootNote(new Note());

// Insert table
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);

// Save the document
document.save("C:\\Files\\PDF\\Table_footnote.pdf");
Insert a Table to Footnote in PDF.

Insert a Table to Footnote in PDF.

تنظیم برچسب و سبک خط پاورقی با استفاده از Java

ما می‌توانیم برچسب پاورقی‌ها و سبک خط پاورقی را در یک سند PDF با دنبال کردن مراحل زیر سفارشی‌سازی کنیم:

  1. Firstly, create an instance of the Document class.
  2. Next, add a Page to the PagesCollection of the document.
  3. سپس یک GraphInfo شیء را برای سفارشی‌سازی سبک خط مقداردهی اولیه کنید.
  4. خصوصیات شیء GraphInfo را تنظیم کنید، مانند LineWidth، Color، DashArray و غیره.
  5. بعد، یک TextFragment ایجاد کنید.
  6. سپس، مقدار Footnote را برای شیء TextFragment تنظیم کنید.
  7. سپس شیء TextState را مقداردهی اولیه کرده و ویژگی‌های مختلفی مانند ForegroundColor، FontStyle و غیره را تنظیم کنید.
  8. بعد از آن، TextFragment را به Paragraphs مجموعه اضافه کنید
  9. به صورت اختیاری، مراحل فوق را تکرار کنید تا TextFragment های بیشتری برای مقادیر چندگانه Footnote اضافه کنید.
  10. در نهایت، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

کد نمونه زیر نشان می‌دهد که چگونه می‌توان لیبل و سبک خط پاورقی‌ها را با استفاده از Java سفارشی کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان برچسب پانوشت‌ها و سبک خط را سفارشی کرد.
// Create Document instance
Document document = new Document();

// صفحه را به مجموعه صفحات PDF اضافه کنید
Page page = document.getPages().add();

// خط سبک سفارشی سازی کنید
// ایجاد شیء GraphInfo
GraphInfo graph = new GraphInfo();

// set line width as 2
graph.setLineWidth(2);

// رنگ شیء گراف را تنظیم کنید
graph.setColor(Color.getRed());

// set dash array value as 3
graph.setDashArray(new int[] { 3 });

// set dash phase value as 1
graph.setDashPhase(1);

// سبک خط پاورقی را برای صفحه به عنوان نمودار تنظیم کنید
page.setNoteLineStyle(graph);

// Create TextFragment instance
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);

// متن Fragment را به مجموعه پاراگراف های صفحه اول سند اضافه کنید
page.getParagraphs().add(text);

// Create another TextFragment
text = new TextFragment("Aspose.Pdf for Java");

// Set Footnote for second text fragment
text.setFootNote(new Note("foot note for second text fragment!"));

// قسمت دوم متن را به مجموعه پاراگراف‌های فایل PDF اضافه کنید
page.getParagraphs().add(text);

// مدرک را ذخیره کن
document.save("C:\\Files\\PDF\\customize_footnote.pdf");
برچسب و سبک خط پاورقی را با استفاده از Java سفارشی کنید.

Customize Footnote Label and Line Style using Java.

برای اضافه کردن یادداشت‌های پا به PDF موجود با استفاده از Java

ما می‌توانیم پاورقی‌ها را به یک سند PDF موجود اضافه کنیم با دنبال کردن مراحل زیر:

  1. Firstly, load a PDF file using the Document class.
  2. در مرحله بعد، یک page خاص را با ایندکس آن دریافت کنید.
  3. سپس، یک TextFragmentAbsorber شیء با عبارت جستجو به عنوان ورودی ایجاد کنید.
  4. پس از آن، متد accept() را برای جستجوی عبارت ورودی از صفحه فراخوانی کنید.
  5. Next, get the first occurrence of search phrase from TextFragmentCollection.
  6. سپس یک TextFragment خالی ایجاد کنید و موقعیت آن را در صفحه تنظیم کنید.
  7. همچنین مقدار Footnote را برای شیء TextFragment تنظیم کنید.
  8. بعد از آن، TextFragment را به Paragraphs مجموعه اضافه کنید
  9. در نهایت، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان یادداشت‌های پایینی را به یک سند PDF موجود با استفاده از Java اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان یادداشت‌های پایینی را به یک سند PDF موجود اضافه کرد.
// یک سند PDF موجود را بارگذاری کنید
Document document = new Document("C:\\Files\\PDF\\sample.pdf");

// Create TextAbsorber object to find all instances of the text phrase
TextFragmentAbsorber textFragmentAbsorber = new TextFragmentAbsorber("Class");

// Get particular page
Page page = document.getPages().get_Item(2);

// Accept the absorber for second page of document
page.accept(textFragmentAbsorber);

// متن‌های استخراج‌شده را در مجموعه قرار دهید
TextFragmentCollection textFragmentCollection = textFragmentAbsorber.getTextFragments();

// متن اولین بار را بدست آورید
TextFragment textFragment = textFragmentCollection.get_Item(1);

// Create an empty TextFragment
TextFragment text = new TextFragment("");

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

// Set Footnote value for 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");
Add-Footnotes-to-Existing-PDF-using-Java

Add Footnotes to Existing PDF using Java.

اضافه کردن یادداشت‌های پایانی به PDF با استفاده از Java

ما می‌توانیم در انتهای یک سند PDF با دنبال کردن مراحل زیر، پاورقی‌ها را نیز اضافه کنیم:

  1. Firstly, create an instance of the Document class.
  2. Next, add a Page to the PagesCollection of the document.
  3. سپس، یک TextFragment ایجاد کنید.
  4. در مرحله بعد، مقدار Endnote را برای شیء TextFragment تنظیم کنید.
  5. به طور اختیاری، یک برچسب سفارشی برای یادداشت انتها تعیین کنید.
  6. After that, add TextFragment to Paragraphs collection.
  7. سرانجام، فایل PDF را با استفاده از Document.Save() متد ذخیره کنید. این متد مسیر فایل خروجی را به عنوان یک آرگومان می‌گیرد.

نمونه کد زیر نشان می‌دهد که چگونه می‌توان یادداشت‌های پایانی را به یک سند PDF با استفاده از Java اضافه کرد.

// این مثال کد نشان می‌دهد که چگونه می‌توان یادداشت‌های پایانی را به یک سند PDF اضافه کرد.
// Create a Document instance
Document doc = new Document();

// صفحه را به مجموعه صفحات PDF اضافه کنید
Page page = doc.getPages().add();

// Create TextFragment instance
TextFragment text = new TextFragment("Hello World");

// مقدار پاورقی را برای TextFragment تنظیم کنید
text.setEndNote(new Note("sample End note"));

// برچسب سفارشی برای یادداشت پا مشخص کنید
text.getEndNote().setText(" Aspose(2015)");

// مجموعه پاراگراف های صفحه اول سند را به TextFragment اضافه کنید
page.getParagraphs().add(text);

// فایل PDF را ذخیره کنید
doc.save("C:\\Files\\PDF\\EndNote.pdf");

دریافت مجوز رایگان API

شما می‌توانید بدون محدودیت‌های ارزیابی API را با درخواست یک مجوز موقت رایگان امتحان کنید.

نتیجه گیری

در این مقاله، یاد گرفته‌ایم که چگونه:

  • add footnotes and endnotes to a PDF document using Java;
  • add an image or a table to footnotes in PDF;
  • با استفاده از Java، برچسب پاورقی و سبک خط را سفارشی کنید؛
  • add footnotes to an existing PDF document using Java.

علاوه بر این، می‌توانید اطلاعات بیشتری درباره Aspose.PDF for Java API با استفاده از documentation بیاموزید. در صورت وجود هر گونه ابهام، لطفاً با کمال میل با ما در forum تماس بگیرید.

به همچنین مشاهده کنید