تُستخدم التعليقات التوضيحية عادةً للأخطاء المذكورة في المستندات أو لمناقشة محتواها. باستخدام التعليقات التوضيحية ، يمكنك تجنب المناقشات الطويلة التي لا تنتهي داخل سلاسل رسائل البريد الإلكتروني. في هذه المقالة ، ستتعلم كيفية إضافة التعليقات التوضيحية وإزالتها برمجيًا لترميز مستندات Word في Java.
فيما يلي المواضيع التي تمت مناقشتها بإيجاز أدناه:
- Java API لتعليقات Word DOC / DOCX
- أضف التعليقات التوضيحية إلى Word
- إزالة التعليقات التوضيحية من ملفات Word
Java API للتعليق على ملفات الكلمات وتوصيفها
يوفر GroupDocs.Annotation واجهة برمجة تطبيقات Java للتعامل مع التعليقات التوضيحية. تسمح واجهة برمجة التطبيقات بإضافة التعليقات التوضيحية وإزالتها واستخراجها من مستندات Word والعديد من تنسيقات الملفات الأخرى. تنسيقات المستندات المدعومة تشمل ؛ جداول البيانات والعروض التقديمية والصور وملفات PDF وصفحات الويب ورسائل البريد الإلكتروني ورسومات Visio.
تنزيل أو تكوين
قم بتنزيل ملف JAR من قسم التنزيلات ، أو احصل على أحدث تكوينات المستودع والتبعية لملف pom.xml لتطبيقات Java المستندة إلى المخضرم.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>21.7.2</version>
</dependency>
أضف التعليقات التوضيحية إلى Word في Java
دعنا نضيف أنواعًا مختلفة من التعليقات التوضيحية إلى مستندات Word. التعليقات التوضيحية من أنواع عديدة ، لذا سنغطي القليل منها هنا.
أضف تعليقًا توضيحيًا على شكل سهم إلى Word في Java
فيما يلي خطوات إضافة تعليق توضيحي على شكل سهم إلى مستند Word في Java.
- قم بتحميل المستند باستخدام فئة Annotator.
- ابدأ تشغيل التعليق التوضيحي للسهم باستخدام فئة ArrowAnnotation.
- اضبط موضع التعليق التوضيحي للسهم وحجمه ورقم الصفحة.
- أضف التعليق التوضيحي للسهم الذي تم إنشاؤه باستخدام طريقة add ().
- احفظ مستند Word المشروح إلى المسار باستخدام طريقة الحفظ المناسبة.
يوضح نموذج التعليمات البرمجية لـ Java التالي كيفية إضافة تعليق توضيحي على شكل سهم إلى مستند Word.
// أضف تعليقًا على شكل سهم إلى مستندات Word في Java
final Annotator annotator = new Annotator("path/document.docx");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100));
arrow.setMessage("Arrow annotation");
arrow.setOpacity(0.7);
arrow.setPageNumber(0);
arrow.setPenColor(0x65535);
arrow.setPenStyle(PenStyle.Dot);
arrow.setPenWidth((byte) 3);
annotator.add(arrow);
annotator.save("path/annotatedDoc.docx");
قم بإدراج مستطيل أو منطقة تعليق توضيحي في Word في Java
فيما يلي خطوات إضافة تعليق توضيحي على شكل مستطيل أو منطقة إلى مستند DOC / DOCX مع بعض التخصيصات. يشبه إضافة تعليقات Arrow التوضيحية ولكنه يستخدم AreaAnnotation.
- قم بتحميل مستند Word DOC / DOCX باستخدام فئة Annotator.
- ابدأ تشغيل التعليق التوضيحي للمستطيل باستخدام فئة AreaAnnotation.
- اضبط موضع المستطيل وحجمه ولونه.
- عيّن خصائص أخرى مثل رقم الصفحة والخلفية والتعتيم والنمط وعرض القلم والرسائل والوقت.
- أضف التعليق التوضيحي للمستطيل الذي تم إنشاؤه إلى التعليق التوضيحي.
- احفظ مستند Word المشروح في المسار باستخدام طريقة الحفظ ().
يوضح نموذج كود Java التالي كيفية إضافة تعليق توضيحي مستطيل / منطقة إلى مستند Word.
// أضف منطقة أو Rectangle Annotation في مستندات Word في Java
final Annotator annotator = new Annotator("path/document.docx");
AreaAnnotation area = new AreaAnnotation();
area.setBackgroundColor(65535);
area.setBox(new Rectangle(100, 100, 100, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("This is area annotation");
area.setOpacity(0.7);
area.setPageNumber(0);
area.setPenColor(65535);
area.setPenStyle(PenStyle.Dot);
area.setPenWidth((byte) 3);
area.setReplies(replies);
annotator.add(area);
annotator.save("path/annotatedDoc.docx");
أضف تعليقًا توضيحيًا بيضاويًا أو ناقصًا إلى Word في Java
فيما يلي خطوات إضافة تعليق توضيحي بيضاوي / بيضاوي إلى مستند في Java.
- قم بتحميل مستند DOC / DOCX باستخدام فئة Annotator.
- قم بتهيئة التعليق التوضيحي للقطع الناقص باستخدام فئة EllipseAnnotation.
- عيّن موضع وحجم التعليق التوضيحي للقطع الناقص الذي تمت تهيئته.
- أضف التعليق التوضيحي الناقص الذي تم إنشاؤه إلى التعليق التوضيحي.
- احفظ ملف Word المشروح باستخدام طريقة الحفظ المناسبة ().
يوضح نموذج كود Java التالي كيفية إضافة تعليق توضيحي بيضاوي / بيضاوي إلى أي مستند Word.
// أضف تعليقًا توضيحيًا بيضاويًا أو ناقصًا في مستندات Word في Java
final Annotator annotator = new Annotator("path/document.docx");
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBackgroundColor(65535);
ellipse.setBox(new Rectangle(100, 100, 100, 100));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("This is ellipse annotation");
ellipse.setOpacity(0.7);
ellipse.setPageNumber(0);
ellipse.setPenColor(65535);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies);
annotator.add(ellipse);
annotator.save("path/annotatedDoc.docx");
أدخل تعليقًا توضيحيًا عن المسافة إلى Word في Java
وبالمثل ، يمكنك ذكر المسافة بين نقطتين باستخدام شرح المسافة. فيما يلي خطوات إضافة تعليق توضيحي عن بعد إلى المستند في Java.
- بعد تحميل مستند Word ، قم بتهيئة التعليق التوضيحي عن بعد باستخدام فئة DistanceAnnotation.
- اضبط مظهر التعليق التوضيحي.
- أضف التعليق التوضيحي عن المسافة إلى كائن التعليقات التوضيحية.
- احفظ المستند المشروح في الموقع المحدد أو استخدم خيار الحفظ الصحيح () ،
يوضح نموذج كود Java التالي كيفية إضافة تعليق توضيحي عن المسافة إلى مستند DOC / DOCX.
// أضف تعليقًا توضيحيًا عن المسافة إلى مستندات Word في Java
final Annotator annotator = new Annotator("path/document.docx");
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(200, 150, 200, 30));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is distance annotation");
distance.setOpacity(0.7);
distance.setPageNumber(0);
distance.setPenColor(65535);
distance.setPenStyle(PenStyle.Dot);
distance.setPenWidth((byte) 3);
distance.setReplies(replies);
annotator.add(distance);
annotator.save("path/annotatedDoc.docx");
إزالة التعليقات التوضيحية من ملفات Word DOC / DOCX في Java
توجد طرق عديدة لإزالة التعليقات التوضيحية من مستندات Word. يمكنك إزالة تعليقات توضيحية معينة عن طريق توفير الفهارس لإزالة التعليقات التوضيحية المحددة. بالإضافة إلى ذلك ، يمكنك إزالة جميع التعليقات التوضيحية مرة واحدة. تمت مناقشة التفاصيل وكود مصدر Java لإزالة التعليقات التوضيحية في مقالة منفصلة.
فيما يلي خطوات إزالة جميع التعليقات التوضيحية من ملف Word.
- قم بتحميل المستند.
- ابدأ خيارات الحفظ.
- اضبط نوع التعليق التوضيحي على بلا.
- احفظ ملف Word. سيكون خالي من التعليقات التوضيحية.
يوضح الكود التالي كيفية إزالة التعليقات التوضيحية من ملف Word في Java.
// قم بإزالة جميع التعليقات التوضيحية من مستند Word في Java
final Annotator annotator = new Annotator("path/annotatedDoc.docx");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
annotator.save("path/annotationsRemoved.docx", saveOptions);
استنتاج
باختصار ، لقد تعلمت كيفية إضافة التعليقات التوضيحية إلى مستندات Word داخل تطبيقات Java. على وجه التحديد ، أضفنا تعليقات الأسهم والقطع الناقص والمنطقة والمسافة إلى ملف Word DOC / DOCX باستخدام GroupDocs.Annotation for Java. علاوة على ذلك ، لقد رأيت أيضًا كيفية إزالة جميع التعليقات التوضيحية من أي ملف Word. الآن ، يمكنك محاولة بناء تطبيق Java الخاص ببرنامج توضيحات المستندات.
تعرف على مزيد من المعلومات حول واجهة برمجة التطبيقات من الوثائق ومستودع GitHub. لمزيد من الاستفسارات ، اتصل بالدعم على المنتدى.