تستخدم التعليقات في مستندات الكلمات ، DOCX أو DOC ، لاقتراح التحسينات والتعديلات. دعنا نستكشف كيفية إدراج التعليقات وكذلك حذف التعليقات أو إزالتها برمجيًا باستخدام Java. يمكنك إضافة اسم المؤلف والأحرف الأولى ونص التعليق والتاريخ والوقت بناءً على متطلباتك. سنقوم بتنفيذ كل هذه المهام باستخدام Aspose.Words for Java API.

هنا سنتعلم حالات الاستخدام التالية المتعلقة بالتعليقات في مستندات Word:

إدراج أو حذف التعليقات في ملفات Word (DOCX / DOC) API - التثبيت

يمكنك تنزيل أحدث إصدار من Aspose.Words for Java API من قسم التنزيلات أو من مستودع Maven ، وفقًا للتكوينات المذكورة أدناه:

مخزن:

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.com/repo/</url>
    </repository>
</repositories>

الاعتماد:

<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words</artifactId>
        <version>20.6</version>
        <classifier>jdk17</classifier>
    </dependency>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words</artifactId>
        <version>20.7</version>
        <classifier>javadoc</classifier>
    </dependency>
</dependencies>

لذلك تم تكوين API الآن ويمكننا المضي قدمًا في استكشاف حالات الاستخدام المختلفة للعمل مع التعليقات في مستندات Word.

قم بإدراج تعليق في مستند Word موجود باستخدام Java

يمكنك إدراج أو إضافة تعليقات في ملفات Microsoft Word الموجودة ، DOCX أو DOC ، باستخدام Aspose.Words for Java API. يمكن أن يكون هذا مفيدًا عند مراجعة المستندات ، مثل يمكن للمشرف اقتراح العديد من التغييرات أو التحسينات على تقرير الجدوى. علاوة على ذلك ، يمكن لأي شخص لديه أذونات تحرير لمستند Word العمل مع التعليقات. تحتاج إلى اتباع الخطوات أدناه لإدراج التعليقات في ملف Word (DOCX / DOC):

  1. قم بتحميل ملف DOCX الحالي مع فئة المستند
  2. قم بإنشاء تعليق
  3. احفظ ملف DOCX

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

// تحميل مستند كلمة المصدر
Document doc = new Document(dataDir + "Comments.docx");

// تهيئة كائن DocumentBuilder
DocumentBuilder builder = new DocumentBuilder(doc);

// إنشاء تعليق جديد
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));

// حفظ ملف الإخراج
doc.save(dataDir + "Comments_Output.docx");

تُظهر لقطة الشاشة أدناه نموذج تعليق تمت إضافته في مستندات Word الحالية:

أدخل التعليق في Word

قم بإدراج تعليق في مستند Word جديد باستخدام Java

التعليقات مفيدة أيضًا عند إنشاء مستند Word جديد. على سبيل المثال ، قد تحتاج بعض النصوص إلى توضيح يمكن شرحه بمساعدة التعليق. وبالمثل ، يمكن أن يكون هناك المئات من حالات الاستخدام حيث يمكن أن تساعد التعليقات أثناء إنشاء ملف DOCX جديد. يمكنك بسهولة إضافة أو إدراج التعليقات باتباع الخطوات التالية:

  1. تهيئة كائن DocumentBuilder
  2. أضف نموذجًا للنص
  3. قم بإنشاء تعليق مخصص
  4. احفظ ملف DOCX

يوضح مقتطف الشفرة أدناه كيفية إدراج التعليقات أثناء إنشاء مستند Word جديد من البداية ، باستخدام Java:

// تهيئة وثيقة كلمة جديدة
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أضف بعض النص
builder.write("Some text is added.");

// إنشاء تعليق جديد
Comment comment = new Comment(doc, "Aspose", "Initials", new java.util.Date());
builder.getCurrentParagraph().appendChild(comment);
comment.getParagraphs().add(new com.aspose.words.Paragraph(doc));
comment.getFirstParagraph().getRuns().add(new com.aspose.words.Run(doc, "Sample Comment"));

// حفظ ملف DOCX الناتج
doc.save(dataDir + "Comments_Output.docx");

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

حذف التعليق في Word

حذف تعليقات محددة من مستند Word باستخدام Java

غالبًا ما يتم حذف التعليقات عندما يتم دمج التحسينات أو التعديلات المقترحة في مستند Word. عندما تحتاج إلى حذف تعليقات معينة ، يمكنك اتباع الخطوات أدناه:

  1. تحميل مستند كلمة المصدر
  2. حدد اسم المؤلف
  3. إزالة التعليقات من المؤلف المحدد

يوضح مقتطف الشفرة أدناه كيفية حذف تعليقات محددة من ملف Word باستخدام Java:

// افتح المستند.
Document doc = new Document(dataDir + "Comments.docx");
String authorName = "Aspose";
// اجمع كل التعليقات في المستند
NodeCollection comments = doc.getChildNodes(NodeType.COMMENT, true);
// ابحث في جميع التعليقات وقم بإزالة تلك التي كتبها مؤلف Aspose.
for (int i = comments.getCount() - 1; i >= 0; i--) {
    Comment comment = (Comment) comments.get(i);
    if (comment.getAuthor().equals(authorName))
        comment.remove();
}
// حفظ ملف DOCX الناتج
doc.save(dataDir + "output.docx");

حذف كافة التعليقات من مستندات Word باستخدام Java

يمكن حذف جميع تعليقات مستند Word مرة واحدة. يمكنك اتباع الخطوات أدناه لإزالة جميع التعليقات:

  1. افتح ملف Word docx
  2. اجمع كل التعليقات في الملف
  3. حذف كافة التعليقات

يوضح مقتطف التعليمات البرمجية التالي كيفية حذف جميع التعليقات من مستندات Word باستخدام Java:

// افتح المستند.
Document doc = new Document(dataDir + "Comments.docx");
// اجمع كل التعليقات في المستند
NodeCollection comments = doc.getChildNodes(com.aspose.words.NodeType.COMMENT, true);
// إزالة كافة التعليقات.
comments.clear();
doc.save(dataDir + "output.docx");

استنتاج

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

أنظر أيضا