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

فيما يلي المواضيع التي تمت مناقشتها بإيجاز أدناه:

Java API للتعليق على ملفات الكلمات وتوصيفها

يوفر [GroupDocs.Annotation] (https://products.groupdocs.com/annotation/) واجهة برمجة تطبيقات Java للتعامل مع التعليقات التوضيحية. تسمح واجهة برمجة التطبيقات بإضافة التعليقات التوضيحية وإزالتها واستخراجها من مستندات Word والعديد من تنسيقات الملفات الأخرى. [تنسيقات المستندات المدعومة] (https://docs.groupdocs.com/annotation/java/supported-document-formats/) تشمل ؛ جداول البيانات والعروض التقديمية والصور وملفات PDF وصفحات الويب ورسائل البريد الإلكتروني ورسومات Visio.

تنزيل أو تكوين

قم بتنزيل ملف JAR من [قسم التنزيلات] (https://downloads.groupdocs.com/annotation) ، أو احصل على أحدث تكوينات المستودع والتبعية لملف pox.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. التعليقات التوضيحية من أنواع عديدة ، لذا سنغطي القليل منها هنا.

أضف التعليقات التوضيحية إلى DOC DOCX باستخدام GroupDocs API

أضف تعليقًا توضيحيًا على شكل سهم إلى Word في Java

فيما يلي خطوات إضافة تعليق توضيحي على شكل سهم إلى مستند Word في Java.

يوضح نموذج التعليمات البرمجية لـ 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");
أضف تعليق سهم برمجيًا في Java و .NET

قم بإدراج مستطيل أو منطقة تعليق توضيحي في Word في Java

فيما يلي خطوات إضافة تعليق توضيحي على شكل مستطيل أو منطقة إلى مستند DOC / DOCX مع بعض التخصيصات. يشبه إضافة تعليقات Arrow التوضيحية ولكنه يستخدم AreaAnnotation.

يوضح نموذج كود 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");
أضف مستطيل أو منطقة تعليق برمجيًا في .NET و Java

أضف تعليقًا توضيحيًا بيضاويًا أو ناقصًا إلى Word في Java

فيما يلي خطوات إضافة تعليق توضيحي بيضاوي / بيضاوي إلى مستند في Java.

يوضح نموذج كود 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");
أضف القطع الناقصة أو الشرح البيضاوي برمجيًا في C # .NET و Java

أدخل تعليقًا توضيحيًا عن المسافة إلى Word في Java

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

يوضح نموذج كود 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");
أضف تعليقًا توضيحيًا عن المسافة برمجيًا في C # .NET و Java

إزالة التعليقات التوضيحية من ملفات Word DOC / DOCX في Java

توجد طرق عديدة لإزالة التعليقات التوضيحية من مستندات Word. يمكنك إزالة تعليقات توضيحية معينة عن طريق توفير الفهارس لإزالة التعليقات التوضيحية المحددة. بالإضافة إلى ذلك ، يمكنك إزالة جميع التعليقات التوضيحية مرة واحدة. تمت مناقشة التفاصيل وكود مصدر Java لإزالة التعليقات التوضيحية في مقالة منفصلة.

فيما يلي خطوات إزالة جميع التعليقات التوضيحية من ملف 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] (https://products.groupdocs.com/annotation/java/). علاوة على ذلك ، لقد رأيت أيضًا كيفية إزالة جميع التعليقات التوضيحية من أي ملف Word. الآن ، يمكنك محاولة بناء تطبيق Java الخاص ببرنامج توضيحات المستندات.

تعرف على مزيد من المعلومات حول واجهة برمجة التطبيقات من [الوثائق] (https://docs.groupdocs.com/annotation/java/) ومستودع [GitHub] (https://github.com/groupdocs-annotation). لمزيد من الاستفسارات ، اتصل بالدعم على [المنتدى] (https://forum.groupdocs.com/).

أنظر أيضا