كيفية إضافة التعليقات التوضيحية إلى ملف PDF
يمكنك إضافة التعليقات التوضيحية النصية في ملف PDF لتلخيص المحتوى المكتوب في المستندات وملاحظة النقاط الحرجة والتفاصيل الأخرى. ومع ذلك ، يمكنك إضافة تعليقات توضيحية نصية في أي مكان في المستند ، وبمجرد إنشائها ، تظهر كنافذة منبثقة وكأيقونة عند إغلاقها. في منشور المدونة هذا ، ستتعلم كيفية إضافة التعليقات التوضيحية إلى ملف PDF باستخدام Java API لملف PDF. بالإضافة إلى ذلك ، ستتعرف على الطرق التي تساعدك في إضافة التعليقات التوضيحية النصية في ملف برمجيًا.
سيتم تناول النقاط التالية في هذا الدليل:
- Java API for PDF - التثبيت
- كيفية إضافة التعليقات التوضيحية إلى ملف PDF
- اقرأ التعليقات التوضيحية النصية
- حذف التعليقات التوضيحية النصية
Java API for PDF - التثبيت
إجراء التثبيت لهذه المكتبة على بعد خطوة واحدة فقط. يمكنك تنزيل API أو تثبيته باستخدام تكوينات 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>
<classifier>jdk17</classifier>
</dependency>
كيفية إضافة التعليقات التوضيحية إلى ملف PDF
الآن ، يمكنك الاستفادة من أساليب مكتبة PDF هذه لتنفيذ إضافة تعليق توضيحي نصي إلى ملف PDF برمجيًا.
يرجى اتباع مقتطف الشفرة والخطوات المذكورة أدناه:
- قم بإنشاء مثيل لفئة Document وتحميل ملف PDF المصدر.
- احصل على صفحة حسب الفهرس باستدعاء طريقة getItem.
- قم بتهيئة كائن من فئة Rectangle الذي يمثل مستطيلاً.
- قم بإنشاء تعليق توضيحي نصي جديد على الصفحة المحددة عن طريق إنشاء كائن من فئة TextAnnotation.
- تحدد طريقة setTitle النص الذي سيتم عرضه في شريط عنوان التعليق التوضيحي.
- setSubject أسلوب مجموعات نص يمثل وصف الكائن.
- setContents تحدد الطريقة نص التعليق التوضيحي.
- إنشاء مثيل منشئ الكائن Border باستخدام كائن textAnnotation.
- اضبط عرض الحدود ونمط الشرطة عن طريق استدعاء الأسلوبين setWidth و setDash.
- قم باستدعاء طريقة add التي تضيف تعليقًا توضيحيًا إلى المجموعة.
- ستحفظ طريقة save ملف التعليقات التوضيحية.
انسخ الكود التالي والصقه في ملفك الرئيسي:
// إنشاء مثيل لفئة المستند وتحميل ملف PDF المصدر.
Document document = new Document( "table.pdf");
// احصل على صفحة حسب الفهرس باستدعاء طريقة get_Item
Page page = document.getPages().get_Item(1);
// قم بتهيئة كائن من فئة المستطيل الذي يمثل المستطيل.
Rectangle rect = new Rectangle(200, 750, 400, 790);
// قم بإنشاء تعليق توضيحي نصي جديد على الصفحة المحددة عن طريق إنشاء كائن من فئة TextAnnotation.
TextAnnotation textAnnotation = new TextAnnotation(page, rect);
// تحدد طريقة setTitle النص الذي سيتم عرضه في شريط عنوان التعليق التوضيحي.
textAnnotation.setTitle("Aspose User");
// تحدد طريقة setSubject النص الذي يمثل وصفًا للكائن.
textAnnotation.setSubject("Sample Subject");
// تحدد طريقة setContents نص التعليق التوضيحي.
textAnnotation.setContents("Sample contents for the annotation");
textAnnotation.setOpen(true);
textAnnotation.setIcon(TextIcon.Circle);
// إنشاء مثيل لكائن الحد مع كائن textAnnotation.
Border border = new Border(textAnnotation);
// اضبط عرض الحدود ونمط الشرطة عن طريق استدعاء طريقة setWidth و setDash.
border.setWidth(5);
border.setDash(new Dash(1, 1));
textAnnotation.setBorder(border);
textAnnotation.setRect(rect);
// قم باستدعاء طريقة الإضافة التي تضيف تعليقًا توضيحيًا إلى المجموعة.
page.getAnnotations().add(textAnnotation);
// طريقة الحفظ ستحفظ ملف التعليق التوضيحي.
document.save( "sample_textannot.pdf");
يمكنك أن ترى الإخراج في الصورة أدناه:
اقرأ التعليقات التوضيحية النصية
وبالمثل ، يمكننا قراءة التعليقات التوضيحية النصية من ملف PDF موجود باتباع الخطوات المذكورة أدناه:
- قم بإنشاء مثيل لفئة Document وقم بتحميل ملف PDF المصدر.
- اتصل بطريقة getItem للحصول على صفحة حسب الفهرس.
- تصفية التعليقات التوضيحية باستخدام AnnotationSelector.
- قم باستدعاء طريقة Accept لقبول الزائر لمعالجة التعليق التوضيحي.
- قم باستدعاء الأسلوب getSelected للحصول على قائمة بكائنات التعليقات التوضيحية المحددة.
- اطبع النتائج.
انسخ الكود التالي والصقه في ملفك الرئيسي:
// إنشاء مثيل لفئة المستند وتحميل ملف PDF المصدر.
Document document = new Document( "sample_textannot.pdf");
// اتصل بطريقة get_Item للحصول على صفحة حسب الفهرس عن طريق استدعاء ملف
Page page = document.getPages().get_Item(1);
// تصفية التعليقات التوضيحية باستخدام AnnotationSelector
AnnotationSelector annotationSelector = new AnnotationSelector(
new TextAnnotation(page, Rectangle.getTrivial()));
// قم باستدعاء طريقة Accept لقبول الزائر لمعالجة التعليق التوضيحي.
page.accept(annotationSelector);
// قم باستدعاء أسلوب getSelected للحصول على قائمة بكائنات التعليقات التوضيحية المحددة.
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// اطبع النتائج
for (Annotation fa : TextAnnotations) {
System.out.println(fa.getRect());
}
حذف التعليقات التوضيحية النصية
بالإضافة إلى ذلك ، يمكنك اتباع الخطوات ومقتطف الشفرة لحذف التعليقات التوضيحية النصية برمجيًا:
- قم بإنشاء كائن من فئة Document وتحميل ملف PDF المصدر.
- تصفية التعليقات التوضيحية باستخدام AnnotationSelector.
- اقبل الزائر بمعالجة التعليق التوضيحي باستدعاء طريقة قبول.
- قم باستدعاء الأسلوب getSelected للحصول على قائمة بكائنات التعليقات التوضيحية المحددة.
- مرر عبر جميع التعليقات التوضيحية النصية واحذف التعليقات التوضيحية باستدعاء طريقة delete.
- استدعاء طريقة save لحفظ الملف.
انسخ الكود التالي والصقه في ملفك الرئيسي:
// قم بإنشاء كائن من فئة Document وقم بتحميل ملف PDF المصدر.
Document document = new Document( "sample_textannot.pdf");
// تصفية التعليقات التوضيحية باستخدام AnnotationSelector
Page page = document.getPages().get_Item(1);
AnnotationSelector annotationSelector = new AnnotationSelector(
new TextAnnotation(page, Rectangle.getTrivial()));
// يقبل الزائر معالجة التعليق التوضيحي عن طريق استدعاء أسلوب القبول
page.accept(annotationSelector);
// قم باستدعاء أسلوب getSelected للحصول على قائمة بكائنات التعليقات التوضيحية المحددة.
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// حلقة من خلال جميع التعليقات التوضيحية النصية
for (Annotation fa : TextAnnotations) {
// احذف التعليق التوضيحي باستدعاء طريقة الحذف
}
// استدعاء طريقة الحفظ لحفظ الملف
document.save ( "sample_textannot_del.pdf");
احصل على رخصة مجانية
يمكنك الاستفادة من ترخيص مؤقت مجاني لتجربة واجهة برمجة التطبيقات بدون قيود تقييمية.
تلخيص لما سبق
هذا يقودنا إلى نهاية منشور المدونة هذا. لقد تعرفت على كيفية إضافة التعليقات التوضيحية في ملف PDF برمجيًا. بالإضافة إلى ذلك ، تعلمت أيضًا كيفية قراءة وحذف التعليقات التوضيحية النصية من مستندات PDF الحالية باستخدام Java API لـ PDF. علاوة على ذلك ، يمكنك زيارة الوثائق لمزيد من استكشاف طرق API.
علاوة على ذلك ، نقترح عليك اتباع دليل البدء.
أخيرًا ، يكتب conholdate.com مشاركات مدونة جديدة. لذلك ، يرجى البقاء على اتصال للحصول على تحديثات منتظمة.
طرح سؤال
يمكنك إخبارنا بأسئلتك أو استفساراتك على المنتدى.
أسئلة وأجوبة
هل يمكنني إضافة تعليقات توضيحية إلى ملف PDF مجانًا؟
يرجى زيارة هذا الرابط لمعرفة مقتطف الشفرة وطرق واجهة برمجة التطبيقات التي تم الكشف عنها بواسطة Java API لملف PDF.