הוסף או הסרה של הערות או קובצי סימון Word באמצעות C#

שכח לדון בתוכן ובמשוב של מסמכים בשרשורי דוא"ל ארוכים. פשוט השתמש בהערות כדי לסמן מסמכים עם הודעות ותשובות. במאמר זה, תלמד כיצד להוסיף ולהסיר הערות באופן פרוגרמטי לסימון מסמכי Word ב-C# עם יישומי NET שלך.

להלן הנושאים הנידונים בקצרה להלן:

• .NET API עבור הערות Word DOC/DOCX
• הוסף הערות ל-Word
  • הערות חצים
  • הערות מלבנים
  • הערות אליפסה או אליפסה
  • הערות מרחק
• הסר הערות מקובצי Word

.NET API להערות ולסימון קובצי Word

GroupDocs.Annotation מספק את ה-.NET API לעבודה עם ההערות עבור המסמכים והתמונות שלך בתוך יישומי NET. ה-API מאפשר לך להוסיף, להסיר ולחלץ הערות ממסמכי Word. יתר על כן, הוא תומך בגיליונות אלקטרוניים, מצגות, תמונות, קבצי PDF, דפי אינטרנט, הודעות דואר אלקטרוני, ציורי Visio. כמה שרטוטי AutoCAD ופורמטים של הדמיה דיגיטלית כמו DICOM נמצאים גם הם ברשימה. לרשימה המלאה של פורמטים נתמכים של מסמכים להערה, אתה יכול לבקר בתיעוד.

הורד את קובצי ה-DLL או ה-MSI מתקין מסעיף ההורדות או התקן את ה-API באפליקציית NET שלך דרך NuGet. אתה יכול גם להשתמש בפקודה הבאה ממנהל החבילות.

PM> Install-Package GroupDocs.Annotation

הוסף הערות ל-Word ב-C#

בואו נוסיף כמה מהסוגים השונים של הערות למסמכי Word. ישנם סוגים רבים ושונים של הערות, לכן נתייחס רק לכמה מהם במאמר זה.

ישנם כמה מסוגי ההערות הנתמכים, אתה יכול למד על כל הערה בנפרד.

• הערת שטח / מלבן
• חֵץ
• לָשִׂים דָגֵשׁ
• סימן מים
• מֶרְחָק
• פסילה
• שדה טקסט
• אֶלִיפְּסָה
• שִׂיא
• קישור
• נְקוּדָה
• פוליליין
• תַחֲלִיף
• חיתוך משאבים
• עריכת טקסט

הוסף הערת חץ ל-Word באמצעות C#

להלן השלבים להוספת הערת חצים למסמך Word ב-C#.

• טען את המסמך באמצעות המחלקה Annotator.
• אתחול הערת חץ עם המחלקה ArrowAnnotation.
• התאם את המיקום, הגודל, מספר העמוד של הערת החץ.
• הוסף את הערת החץ שנוצרה בשיטת Add.
• שמור את מסמך ה-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 עם כמה התאמות אישיות. זה דומה מאוד להוספת הערות חץ אבל משתמש במחלקת AreaAnnotation הפעם.

• טען את מסמך DOC/DOCX באמצעות המחלקה Annotator.
• אתחול הערת מלבן באמצעות המחלקה AreaAnnotation.
• התאם את המיקום, הגודל והצבע של המלבן.
• הגדר מאפיינים אחרים כמו מספר עמוד, רקע, אטימות, סגנון, רוחב עט, הודעות וזמן.
• הוסף את הערת המלבן שנוצרה ל-Annotator.
• שמור את הקובץ המובא בנתיב בשיטת שמור.

דוגמת הקוד הבאה מראה כיצד להוסיף הערת מלבן/אזור למסמך 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.
• הגדר את סוגי ההערות ל-None.
• שמור את קובץ ה-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. יתר על כן, ראית גם כיצד להסיר את כל ההערות מכל קובץ וורד. כעת, אתה יכול לחשוב לבנות יישום NET.NET של עורך מסמכים משלך.

למד עוד על GroupDocs.Annotation עבור .NET מהמאגר תיעוד ו-GitHub. לשאלות נוספות, צור קשר עם התמיכה בפורום.

ראה גם

• הוסף סימן מים לתמונות באמצעות C#
• הערות לקבצי PDF ב-Java