حول GroupDocs.Annotation for Net API

GroupDocs.Annotation for Net API مكتبة تسمح لك بإضافة التعليقات التوضيحية إلى PDF و Word والمستندات الأخرى على Mac أو Windows أو Ubuntu. [GroupDocs.Annotation for Net] (/annotation/net) هي واجهة برمجة تطبيقات Net أصلية لإدارة التعليقات التوضيحية مع دعم شامل لإنشاء التعليقات التوضيحية وإضافتها وتحريرها وحذفها واستخراجها وتصديرها من الصور ومستندات أخرى متنوعة. القائمة الكاملة لتنسيقات المستندات المدعومة التي يمكن أن تراها في هذه الصفحة. تتيح لك هذه المكتبة العمل ليس فقط مع مستند DOCX ولكن أيضًا مع العديد من أنواع المستندات الأخرى مثل Word و Excel و PowerPoint ورسائل البريد الإلكتروني في Outlook و Visio و Adobe و OpenDocument و OpenOffice و Photoshop و AutoCad وغيرها الكثير. تسمح لك GroupDocs.Annotation for Net API بإنشاء وإضافة ملاحظات جديدة وتعديل التعليقات التوضيحية واستخراج التعليقات والتعليقات التوضيحية وإزالتها من المستندات. تدعم المكتبة 13 نوعًا مختلفًا من التعليقات التوضيحية ، بما في ذلك Text و Polyline و Area و Underline و Point و Watermark و Arrow و Ellipse واستبدال النص والمسافة وحقل النص وتحرير الموارد في PDF و HTML ومستندات Microsoft Word وجداول البيانات والمخططات والعروض التقديمية ، الرسومات والصور والعديد من تنسيقات الملفات الأخرى. يوضح المثال (يرجى الاطلاع أدناه) العمل مع مستند DOCX ، في هذا المثال يمكنك رؤية الخطوات الرئيسية لكيفية العمل مع GroupDocs.Annotation: إعداد ترخيص ، افتح المستند الذي تريد العمل معه ، وإنشاء التعليق التوضيحي وإضافة كائنات البيانات لتعيين خصائص التعليقات التوضيحية وفقًا لمتطلباتك وحفظ النتيجة في المكان المطلوب. يمكنك أيضًا إلقاء نظرة أكثر تفصيلاً على الميزات المدعومة على github صفحة ، أو في منتجنا التوثيق.

خطوات إضافة التعليقات التوضيحية إلى DOCX في الشبكة

GroupDocs.Annotation يسهل على مطوري الإنترنت إضافة أنواع مختلفة من التعليقات التوضيحية إلى ملفات DOCX داخل أي تطبيق قائم على الشبكة من خلال تنفيذ بضع خطوات سهلة.

  • إنشاء كائنات الرد مع التعليق والتاريخ.
  • إنشاء كائن AreaAnnotation ، وتعيين خيارات المنطقة وإضافة الردود.
  • إنشاء كائن التعليق التوضيحي وإضافة تعليق توضيحي للمنطقة.
  • حفظ ملف الإخراج.

متطلبات النظام

GroupDocs.Annotation for Net APIs مدعومة على جميع الأنظمة الأساسية وأنظمة التشغيل الرئيسية. قبل تنفيذ الكود أدناه ، يرجى التأكد من تثبيت المتطلبات الأساسية التالية على نظامك.

  • أنظمة التشغيل: مايكروسوفت ويندوز ، لينوكس ، ماك
  • بيئات التطوير: Visual Studio و Xamarin و MonoDevelop
  • الأطر: .NET Framework و .NET Standard و .NET Core و Mono
  • قم بتنزيل أحدث إصدار من GroupDocs.Annotation for .NET من NuGet

معاينة الشرح وعينة التعليمات البرمجية

//Add text field annotation to the document from local disk
using (Annotator annotator = new Annotator("input.bmp"))
{
    TextFieldAnnotation textField = new TextFieldAnnotation
    {
        BackgroundColor = 65535,
        Box = new Rectangle(100, 100, 100, 100),
        CreatedOn = DateTime.Now,
        Text = "Some text",
        FontColor = 65535,
        FontSize = 12,
        Message = "This is text field annotation",
        Opacity = 0.7,
        PageNumber = 0,
        PenStyle = PenStyle.Dot,
        PenWidth = 3,
        FontFamily = "Arial",
        TextHorizontalAlignment = HorizontalAlignment.Center,
        Replies = new List
        {
            new Reply
            {
                Comment = "First comment",
                RepliedOn = DateTime.Now
            },
            new Reply
            {
                Comment = "Second comment",
                RepliedOn = DateTime.Now
            }
        }
    };
    annotator.Add(textField);
    annotator.Save("result.bmp");
}

Annotation preview image

خطوات إزالة التعليقات التوضيحية من DOCX في الشبكة

GroupDocs.Annotation يسهل على مطوري الإنترنت إزالة تفاصيل التعليقات التوضيحية من ملفات DOCX داخل أي تطبيق قائم على الشبكة من خلال تنفيذ بضع خطوات سهلة.

  • إنشاء كائنات الرد مع التعليق والتاريخ.
  • إنشاء كائن SaveOptions وتعيين AnnotationTypes = AnnotationType.None.
  • استدعاء طريقة حفظ مع مسار المستند الناتج أو دفق وكائن SaveOptions.

// 1- How to remove annotation from document using annotation index

using (Annotator annotator = new Annotator("result.bmp"))
{
    annotator.Remove(0);
    annotator.Save("removed.bmp");
}

// 2- How to remove annotation from document using annotation object

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp[0]);
    annotator.Save("removed.bmp");
}

// 3- How to remove some annotations from document using list of ID’s

using (Annotator annotator = new Annotator("result.bmp"))
{
    var idList = new List{1, 2, 3};
    annotator.Remove(idList);
    annotator.Save("removed.bmp");
}

// 4- How to remove some annotations from document using list of annotations

using (Annotator annotator = new Annotator("result.bmp"))
{
    var tmp = annotator.Get();
    annotator.Remove(tmp);
    annotator.Save("removed.bmp");
}

خطوات تحرير التعليقات التوضيحية من DOCX في الشبكة

GroupDocs.Annotation يسهل على مطوري الإنترنت تحديث خصائص التعليقات التوضيحية المتنوعة من ملفات DOCX داخل أي تطبيق قائم على الشبكة من خلال تنفيذ بضع خطوات سهلة.

  • إنشاء كائن Annotator مع مسار مستند الإدخال أو دفق مع LoadOptions تم إنشاء مثيل له مع ImportAnnotations = true.
  • قم بإنشاء بعض تنفيذ AnnotationBase وقم بتعيين معرف التعليقات التوضيحية الموجودة (إذا لم يتم العثور على التعليق التوضيحي بهذا المعرف ، فلن يتم تغيير أي شيء) أو قائمة مسار التعليقات التوضيحية (ستتم إزالة جميع التعليقات التوضيحية الموجودة).
  • طريقة تحديث المكالمة لكائن Annotator مع التعليقات التوضيحية التي تم تمريرها.
  • استدعاء طريقة حفظ مع مسار المستند الناتج أو دفق وكائن SaveOptions.

// open annotated document
using (Annotator annotator = new Annotator("result.bmp"))
{
    //assuming we are going to change some properties of existing annotation
        AreaAnnotation updated = new AreaAnnotation
            {
                    // It's important to set existed annotation Id
                    Id = 1,
                    BackgroundColor = 255,
                    Box = new Rectangle(0, 0, 50, 200),
                    CreatedOn = DateTime.Now,
                    Message = "This is updated annotation",
                    Replies = new List
                    {
                        new Reply
                        {
                            Comment = "Updated first comment",
                            RepliedOn = DateTime.Now
                        },
                        new Reply
                        {
                            Comment = "Updated second comment",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
        // update annotation
        annotator.Update(updated);
        annotator.Save("result.bmp");
}

خطوات استخراج التعليقات التوضيحية من DOCX في الشبكة

GroupDocs.Annotation يُسهل على مطوري Net وضع تعليقات توضيحية على المستندات واستخراج معلومات التعليقات التوضيحية من ملفات DOCX داخل أي تطبيق مستند إلى Net عن طريق تنفيذ بضع خطوات سهلة.

  • إنشاء كائنات الرد مع التعليق والتاريخ.
  • إنشاء كائن LoadOptions واستدعاء SetImportAnnotations باستخدام وسيطة صحيحة.
  • تحديد متغير مع نوع القائمة.
  • استدعاء طريقة الحصول وإرجاع النتيجة إلى المتغير أعلاه.

// for using this example input file ("annotated.bmp") must be with annotations
using (Annotator annotator = new Annotator("annotated.bmp"))
{
    List annotations = annotator.Get();
    XmlSerializer formatter = new XmlSerializer(typeof(List));
    using (FileStream fs = new FileStream("annotations.xml", FileMode.Create))
    {
        fs.SetLength(0);
        formatter.Serialize(fs, annotations);
    }
}

العروض التوضيحية الحية لإضافة التعليقات التوضيحية إلى المستندات والصور وإزالتها وتحريرها واستخراجها

قم بإضافة التعليقات التوضيحية وإزالتها وتعديلها واستخراجها إلى ملف DOCX الآن من خلال زيارة موقع ويب GroupDocs.Annotation Live Demos. يحتوي العرض التوضيحي المباشر على الفوائد التالية

لا حاجة لتنزيل API

لا حاجة لكتابة أي رمز

فقط قم بتحميل الملف المصدر

احصل على رابط التنزيل لحفظ الملف

حول تنسيق الملف DOCX

DOCX هو تنسيق معروف لمستندات Microsoft Word. تم تقديمه من عام 2007 مع إصدار Microsoft Office 2007 ، تم تغيير هيكل تنسيق المستند الجديد هذا من ثنائي عادي إلى مجموعة من ملفات XML والملفات الثنائية. يمكن فتح ملفات Docx باستخدام Word 2007 والإصدارات الجانبية ولكن ليس بالإصدارات السابقة من MS Word التي تدعم امتدادات ملفات DOC.

اقرأ أكثر حول تنسيق الملف DOCX

العمل مع تنسيقات المستندات الشائعة الأخرى

قم بتحديث خصائص التعليقات التوضيحية من بعض تنسيقات الملفات الشائعة كما هو موضح أدناه.

Annotate PDF document

(Adobe Portable Document Format)

Annotate DOC document

(Microsoft Word Document)

Annotate DOCM document

(Microsoft Word Macro-Enabled Document)

Annotate DOCX document

(Microsoft Word Open XML Document)

Annotate DOT document

(Microsoft Word Document Template)

Annotate DOTX document

(Word Open XML Document Template)

Annotate RTF document

(Rich Text Document)

Annotate ODT document

(Open Document Text)

Annotate XLS document

(Microsoft Excel Binary File Format)

Annotate XLSX document

(Microsoft Excel Open XML Spreadsheet)

Annotate XLSM document

(Microsoft Excel Macro-Enabled Spreadsheet)

Annotate XLSB document

(Microsoft Excel Binary Worksheet)

Annotate ODS document

(Open Document Spreadsheet)

Annotate PPT document

(PowerPoint Presentation)

Annotate PPTX document

(PowerPoint Open XML Presentation)

Annotate PPSX document

(PowerPoint Open XML Slide Show)

Annotate POTM document

(Microsoft PowerPoint Template)

Annotate PPTM document

(Microsoft PowerPoint Presentation)

Annotate PPS document

(Microsoft PowerPoint 97-2003 Slide Show)

Annotate ODP document

(OpenDocument Presentation)

Annotate HTML document

(HyperText Markup Language)

Annotate TIFF document

(Tagged Image File Format)

Annotate PNG document

(Portable Network Graphic)

Annotate EML document

(E-mail Message)

Annotate MSG document

(Microsoft Outlook E-mail Message)

Annotate VSD document

(Microsoft Visio 2003-2010 Drawing)

Annotate VSDX document

(Microsoft Visio Drawing)

Annotate VSS document

(Microsoft Visio 2003-2010 Stencil)

Annotate VST document

(Microsoft Visio 2013 Stencil)

Annotate DWG document

(Autodesk Design Data Formats)

Annotate DXF document

(AutoCAD Drawing Interchange)

Annotate DCM document

(Digital Imaging and Communications in Medicine)

Annotate WMF document

(Windows Metafile)

Annotate EMF document

(Enhanced Metafile Format)

Back to top
 العربية