إضافة أو إزالة التعليقات التوضيحية أو ملفات الترميز باستخدام C #

نسيان مناقشة محتوى المستندات والتعليقات في سلاسل البريد الإلكتروني الطويلة. ما عليك سوى استخدام التعليقات التوضيحية لتمييز المستندات بالرسائل والردود. في هذه المقالة ، ستتعلم كيفية إضافة التعليقات التوضيحية وإزالتها برمجيًا لتمييز مستندات Word في C # باستخدام تطبيقات .NET.

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

• NET API لتعليقات Word DOC / DOCX
• أضف التعليقات التوضيحية إلى Word
  • شروح السهم
  • شروح المستطيل
  • شروح بيضاوية أو بيضاوية
  • شروح المسافة
• إزالة التعليقات التوضيحية من ملفات Word

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

GroupDocs.Annotation يوفر .NET API للعمل مع التعليقات التوضيحية لمستنداتك وصورك داخل تطبيقات .NET. تسمح لك واجهة برمجة التطبيقات بإضافة التعليقات التوضيحية وإزالتها واستخراجها من مستندات Word. علاوة على ذلك ، فهو يدعم جداول البيانات والعروض التقديمية والصور وملفات PDF وصفحات الويب ورسائل البريد الإلكتروني ورسومات Visio. بعض رسومات AutoCAD وتنسيقات التصوير الرقمي مثل DICOM مدرجة أيضًا في القائمة. للحصول على قائمة كاملة تنسيقات المستندات المدعومة للتعليق ، يمكنك زيارة الوثائق.

قم بتنزيل مثبت DLL أو MSI من قسم التنزيلات أو قم بتثبيت API في تطبيق .NET عبر NuGet. يمكنك أيضًا استخدام الأمر التالي من مدير الحزم.

PM> Install-Package GroupDocs.Annotation

إضافة التعليقات التوضيحية إلى Word في C

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

هناك بعض أنواع التعليقات التوضيحية المدعومة ، يمكنك التعرف على كل تعليق توضيحي على حدة.

• شرح منطقة / مستطيل
• سهم
• تسطير
• علامة مائية
• مسافه: بعد
• شطب
• مجال التحرير مكان كتابة النص
• الشكل البيضاوي
• تسليط الضوء
• نهاية لهذه الغاية
• نقطة
• متعدد الخطوط
• إستبدال
• تنقيح الموارد
• تنقيح النص

إضافة تعليق توضيحي على شكل سهم إلى Word باستخدام C

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

• قم بتحميل المستند باستخدام فئة Annotator.
• قم بتهيئة شرح السهم باستخدام فئة ArrowAnnotation.
• اضبط موضع التعليق التوضيحي للسهم وحجمه ورقم الصفحة.
• أضف التعليق التوضيحي للسهم الذي تم إنشاؤه باستخدام طريقة إضافة.
• احفظ مستند Word المشروح إلى المسار باستخدام طريقة حفظ.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي على شكل سهم إلى مستند Word باستخدام C #.

// أضف تعليقًا على شكل سهم إلى مستندات Word باستخدام C #
using (Annotator annotator = new Annotator("path/document.docx"))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(100, 100, 50, 50),
        CreatedOn = DateTime.Now,
        Message = "Your Message",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2
    };
    annotator.Add(arrow);
    annotator.Save("path/annotation.docx");
}

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

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

• قم بتحميل مستند DOC / DOCX باستخدام فئة Annotator.
• قم بتهيئة شرح المستطيل باستخدام فئة AreaAnnotation.
• اضبط موضع المستطيل وحجمه ولونه.
• عيّن خصائص أخرى مثل رقم الصفحة والخلفية والتعتيم والنمط وعرض القلم والرسائل والوقت.
• أضف التعليق التوضيحي للمستطيل الذي تم إنشاؤه إلى التعليق التوضيحي.
• احفظ الملف المشروح إلى المسار باستخدام طريقة حفظ.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي مستطيل / منطقة إلى مستند Word باستخدام C #.

// إضافة منطقة أو مستطيل الشرح في مستندات Word باستخدام C #
using (Annotator annotator = new Annotator("path/document.docx"))
{
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    annotator.Add(area);
    annotator.Save("path/annotation.docx");
}

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

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

• قم بتحميل مستند DOC / DOCX باستخدام فئة Annotator.
• بدء شرح القطع الناقص باستخدام فئة EllipseAnnotation.
• عيّن موضع وحجم التعليق التوضيحي للقطع الناقص الذي تمت تهيئته.
• أضف التعليق التوضيحي الناقص الذي تم إنشاؤه إلى كائن التعليقات التوضيحية.
• قم بتوفير المسار وحفظ ملف Word المشروح باستخدام طريقة حفظ.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي بيضاوي أو بيضاوي إلى مستند Word باستخدام C #.

// أضف تعليقًا توضيحيًا بيضاويًا أو ناقصًا في مستندات Word باستخدام C #
using (Annotator annotator = new Annotator("path/document.docx"))
{
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    annotator.Add(ellipse);
    annotator.Save("path/annotation.docx");
}

إدراج تعليق توضيحي عن المسافة إلى Word باستخدام C

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

• بعد تحميل مستند Word ، قم بتهيئة التعليق التوضيحي عن بعد باستخدام فئة DistanceAnnotation.
• اضبط مظهر التعليق التوضيحي.
• أضف التعليق التوضيحي عن المسافة إلى كائن التعليقات التوضيحية.
• احفظ ملفات Word المشروحة في الموقع المحدد عن طريق تحديد المسار.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي عن المسافة إلى مستند DOC / DOCX باستخدام C #.

// أضف تعليقًا توضيحيًا عن المسافة إلى مستندات Word باستخدام C #
using (Annotator annotator = new Annotator("path/document.docx"))
{
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(distance);
    annotator.Save("path/annotation.docx");
}

كود كامل

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

// إضافة العديد من التعليقات التوضيحية إلى Word باستخدام C #
// إضافة سهم ، ومساحة ، وبيضاوي (قطع ناقص) ، وشروح المسافة إلى DOC / DOCX مع الرسائل والردود باستخدام C #
string outputPath = @"outputPath/annotatedDoc.docx";
string inputFile = @"inputPath/document.docx";

using (Annotator annotator = new Annotator(inputFile))
{
    ArrowAnnotation arrow = new ArrowAnnotation
    {
        Box = new Rectangle(550, 250, 60, -60),
        CreatedOn = DateTime.Now,
        Message = "This image is little upwards.",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -3407872,
        PenStyle = PenStyle.Solid,
        PenWidth = 2,
        Replies = new List<Reply>
        {
            new Reply
            {
                Comment = "Please look in to these issues.",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                    Comment = "Change Description",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "On-Premises APIs",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Add images as well.",
                RepliedOn = DateTime.Now
            }
        }
    };
    AreaAnnotation area = new AreaAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(80, 75, 450, 135),
        Message = "This is area annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -131,
        PenStyle = PenStyle.Dash,
        PenWidth = 3
    };
    EllipseAnnotation ellipse = new EllipseAnnotation
    {
        BackgroundColor = -16034924,
        Box = new Rectangle(275, 475, 300, 80),
        Message = "This is ellipse annotation",
        Opacity = 0.2,
        PageNumber = 0,
        PenColor = -16034924,
        PenStyle = PenStyle.Dot,
        PenWidth = 3
    };
    DistanceAnnotation distance = new DistanceAnnotation
    {
        Box = new Rectangle(750, 235, 0, 150),
        Message = "This is the heading area",
        Opacity = 0.7,
        PageNumber = 0,
        PenColor = -21197,
        PenStyle = PenStyle.Solid,
        PenWidth = 3
    };
    annotator.Add(arrow);
    annotator.Add(area);
    annotator.Add(ellipse);
    annotator.Add(distance);

    annotator.Save(outputPath);
}

إزالة التعليقات التوضيحية من ملفات Word DOC / DOCX باستخدام C

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

فيما يلي خطوات إزالة جميع التعليقات التوضيحية من ملف Word.

• قم بتحميل المستند.
• تهيئة خيارات الحفظ باستخدام فئة SaveOptions.
• عيّن أنواع التعليقات التوضيحية إلى بلا.
• احفظ ملف Word. لن تحتوي على أي تعليق توضيحي فيه.

يوضح الكود التالي كيفية إزالة التعليقات التوضيحية من ملف Word باستخدام C #.

// قم بإزالة جميع التعليقات التوضيحية من مستند Word باستخدام C #
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

استنتاج

باختصار ، لقد تعلمت كيفية إضافة التعليقات التوضيحية إلى مستندات Word داخل تطبيقات .NET باستخدام C #. على وجه التحديد ، أضفنا التعليقات التوضيحية للسهم والقطع الناقص والمنطقة والمسافة إلى ملف Word DOC / DOCX. علاوة على ذلك ، لقد رأيت أيضًا كيفية إزالة جميع التعليقات التوضيحية من أي ملف Word. الآن ، يمكنك التفكير في إنشاء تطبيق .NET الخاص ببرنامج توضيحي للمستند.

تعرف على المزيد حول GroupDocs.Annotation for .NET من التوثيق ومستودع GitHub. لمزيد من الاستفسارات ، اتصل بالدعم على المنتدى.

أنظر أيضا

• أضف علامة مائية إلى الصور باستخدام C #
• علق ملفات PDF في جافا