افزودن یا حذف حاشیه نویسی یا نشانه گذاری فایل های Word با استفاده از سی شارپ

بحث در مورد محتوای اسناد و بازخورد در موضوعات طولانی ایمیل را فراموش نکنید. به سادگی از حاشیه نویسی برای نشانه گذاری اسناد با پیام ها و پاسخ ها استفاده کنید. در این مقاله، نحوه افزودن و حذف حاشیه نویسی برای نشانه گذاری اسناد Word در C# را با برنامه های .NET خود به صورت برنامه نویسی یاد خواهید گرفت.

موضوعات زیر به اختصار مورد بحث قرار گرفته است:

• NET API برای حاشیه نویسی Word DOC/DOCX
• اضافه کردن حاشیه نویسی به Word
  • حاشیه نویسی های پیکان
  • حاشیه نویسی مستطیل
  • حاشیه نویسی بیضی یا بیضی
  • حاشیه نویسی از راه دور
• حاشیه نویسی ها را از فایل های Word حذف کنید

NET API برای حاشیه نویسی و نشانه گذاری فایل های Word

GroupDocs.Annotation .NET API را برای کار با حاشیه نویسی برای اسناد و تصاویر شما در برنامه های NET شما فراهم می کند. API به شما امکان اضافه کردن، حذف و استخراج حاشیه نویسی از اسناد Word را می دهد. علاوه بر این، از صفحات گسترده، ارائه ها، تصاویر، فایل های PDF، صفحات وب، پیام های ایمیل، نقشه های Visio پشتیبانی می کند. برخی از نقشه های اتوکد و فرمت های تصویربرداری دیجیتال مانند DICOM نیز در این لیست هستند. برای فهرست کامل قالب‌های سند پشتیبانی شده برای حاشیه‌نویسی، می‌توانید از مستندات دیدن کنید.

نصب کننده DLL یا MSI را از بخش دانلودها دانلود کنید یا از طریق NuGet API را در برنامه .NET خود نصب کنید. همچنین می توانید از دستور زیر از Package Manager استفاده کنید.

PM> Install-Package GroupDocs.Annotation

اضافه کردن حاشیه نویسی به Word در C#

بیایید برخی از انواع مختلف حاشیه نویسی را به اسناد Word اضافه کنیم. انواع مختلفی از حاشیه نویسی وجود دارد، بنابراین در این مقاله تنها به چند مورد اشاره خواهیم کرد.

برخی از انواع حاشیه نویسی پشتیبانی شده وجود دارد، می توانید [در مورد هر حاشیه نویسی به طور جداگانه بیاموزید12.

• حاشیه نویسی ناحیه / مستطیل
• فلش
• زیر خط بکشید
• واترمارک
• فاصله
• ضربه زدن
• فیلد متن
• بیضی
• برجسته
• ارتباط دادن
• نقطه
• پلی لاین
• جایگزینی
• ویرایش منابع
• ویرایش متن

اضافه کردن حاشیه نویسی پیکان به Word با استفاده از C#

مراحل زیر برای افزودن حاشیه نویسی فلش به سند Word در C# است.

• سند را با استفاده از کلاس Annotator بارگیری کنید.
• حاشیه نویسی پیکان را با کلاس ArrowAnnotation راه اندازی کنید.
• موقعیت، اندازه، شماره صفحه حاشیه نویسی فلش را تنظیم کنید.
• حاشیه نویسی پیکان ایجاد شده را با استفاده از روش Add اضافه کنید.
• سند Word مشروح شده را با استفاده از روش Save در مسیر ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن حاشیه نویسی فلش را با استفاده از C# به یک سند Word نشان می دهد.

// اضافه کردن حاشیه نویسی پیکان به اسناد 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");
}

درج مستطیل یا حاشیه نویسی ناحیه در ورد با استفاده از C#

هنگام افزودن هر حاشیه‌نویسی به سند، می‌توان سفارشی‌سازی‌ها را انجام داد. مراحل زیر برای افزودن حاشیه نویسی مستطیل یا ناحیه به یک سند DOC/DOCX با برخی تنظیمات سفارشی ارائه شده است. این بسیار شبیه به اضافه کردن حاشیه نویسی Arrow است اما این بار از کلاس AreaAnnotation استفاده می کند.

• سند DOC/DOCX را با استفاده از کلاس Annotator بارگیری کنید.
• با استفاده از کلاس AreaAnnotation حاشیه نویسی مستطیل را راه اندازی کنید.
• موقعیت، اندازه و رنگ مستطیل را تنظیم کنید.
• ویژگی های دیگر مانند شماره صفحه، پس زمینه، کدورت، سبک، عرض قلم، پیام ها و زمان را تنظیم کنید.
• حاشیه نویسی مستطیل ایجاد شده را به Annotator اضافه کنید.
• فایل مشروح شده را با استفاده از روش Save در مسیر ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن حاشیه نویسی مستطیل/ناحیه به سند 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 حاشیه نویسی بیضی را راه اندازی کنید.
• موقعیت و اندازه حاشیه نویسی بیضی اولیه را تنظیم کنید.
• حاشیه نویسی بیضی ایجاد شده را به شی Annotator اضافه کنید.
• مسیر را ارائه کنید و فایل ورد مشروح شده را با استفاده از روش Save ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن حاشیه نویسی بیضی یا بیضی به یک سند 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");
}

درج حاشیه نویسی فاصله در ورد با استفاده از C#

به طور مشابه، می توانید حاشیه نویسی فاصله را برای علامت گذاری فاصله بین دو نقطه اضافه کنید. در زیر مراحل اضافه کردن حاشیه نویسی فاصله به سند آمده است.

• پس از بارگیری سند Word، حاشیه نویسی فاصله را با استفاده از کلاس DistanceAnnotation مقداردهی اولیه کنید.
• ظاهر حاشیه نویسی را تنظیم کنید.
• حاشیه نویسی فاصله را به شی Annotator اضافه کنید.
• فایل های 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});
}

نتیجه

به طور خلاصه، شما یاد گرفته اید که چگونه با استفاده از سی شارپ، حاشیه نویسی را در برنامه های .NET به اسناد Word اضافه کنید. به طور خاص، ما حاشیه‌نویسی‌های پیکان، بیضی، ناحیه و فاصله را به فایل Word DOC/DOCX اضافه کردیم. علاوه بر این، نحوه حذف تمام حاشیه نویسی ها از هر فایل Word را نیز مشاهده کرده اید. اکنون، می توانید فکر کنید که برنامه .NET حاشیه نویس اسناد خود را بسازید.

از مخزن documentation و GitHub درباره GroupDocs.Annotation برای .NET بیشتر بیاموزید. برای سوالات بیشتر، با پشتیبانی در [فروم 28 تماس بگیرید.

همچنین ببینید

• اضافه کردن واترمارک به تصاویر با استفاده از سی شارپ
• حاشیه نویسی فایل های PDF در جاوا