เพิ่มหรือลบคำอธิบายประกอบหรือไฟล์มาร์กอัป 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 อยู่ในรายการด้วย สำหรับรายการทั้งหมดของ รูปแบบเอกสารที่รองรับสำหรับคำอธิบายประกอบ คุณสามารถไปที่เอกสารประกอบ

ดาวน์โหลดโปรแกรมติดตั้ง DLLs หรือ MSI จาก ส่วนการดาวน์โหลด หรือติดตั้ง API ในแอปพลิเคชัน .NET ของคุณผ่าน NuGet คุณสามารถใช้คำสั่งต่อไปนี้จาก Package Manager

PM> Install-Package GroupDocs.Annotation

เพิ่มคำอธิบายประกอบใน Word ใน C#

มาเพิ่มคำอธิบายประกอบประเภทต่างๆ ลงในเอกสาร Word กันเถอะ คำอธิบายประกอบมีหลายประเภท ดังนั้นเราจะกล่าวถึงเพียงไม่กี่รายการในบทความนี้

มีคำอธิบายประกอบบางประเภทที่รองรับ คุณสามารถ เรียนรู้เกี่ยวกับคำอธิบายประกอบแต่ละรายการทีละรายการ

• คำอธิบายประกอบพื้นที่ / สี่เหลี่ยมผืนผ้า
• ลูกศร
• ขีดเส้นใต้
• ลายน้ำ
• ระยะทาง
• ขีดฆ่า
• ช่องข้อความ
• วงรี
• ไฮไลต์
• ลิงค์
• จุด
• โพลีไลน์
• เปลี่ยน
• การแก้ไขทรัพยากร
• การโต้ตอบข้อความ

เพิ่มคำอธิบายประกอบ Arrow ให้กับ Word โดยใช้ C#

ต่อไปนี้เป็นขั้นตอนในการเพิ่มคำอธิบายประกอบลูกศรให้กับเอกสาร Word ใน C#

• โหลดเอกสารโดยใช้คลาส Annotator
• เริ่มต้นคำอธิบายประกอบลูกศรด้วยคลาส ArrowAnnotation
• ปรับตำแหน่ง ขนาด หมายเลขหน้าของคำอธิบายประกอบลูกศร
• เพิ่มคำอธิบายประกอบลูกศรที่สร้างขึ้นโดยใช้เมธอด Add
• บันทึกเอกสาร Word ที่มีคำอธิบายประกอบไปยังเส้นทางโดยใช้เมธอด Save

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบลูกศรในเอกสาร Word โดยใช้ C#

// เพิ่มคำอธิบายประกอบ Arrow ให้กับเอกสาร 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
• ปรับตำแหน่ง ขนาด และสีของสี่เหลี่ยมผืนผ้า
• ตั้งค่าคุณสมบัติอื่นๆ เช่น หมายเลขหน้า พื้นหลัง ความทึบ สไตล์ ความกว้างปากกา ข้อความ และเวลา
• เพิ่มคำอธิบายประกอบสี่เหลี่ยมผืนผ้าที่สร้างขึ้นใน 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
• กำหนดตำแหน่งและขนาดของคำอธิบายประกอบวงรีเริ่มต้น
• เพิ่มคำอธิบายประกอบวงรีที่สร้างขึ้นไปยังวัตถุคำอธิบายประกอบ
• ระบุเส้นทางและบันทึกไฟล์ 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
• ตั้งค่าลักษณะของคำอธิบายประกอบ
• เพิ่มคำอธิบายประกอบระยะทางให้กับวัตถุ 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#
// การเพิ่ม Arrow, Area, Oval (Ellipse), Distance annotation ให้กับ 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 จาก documentation และ GitHub repository หากต้องการสอบถามเพิ่มเติม โปรดติดต่อฝ่ายสนับสนุนใน ฟอรัม

ดูสิ่งนี้ด้วย

• เพิ่มลายน้ำให้กับรูปภาพโดยใช้ C#
• ใส่คำอธิบายประกอบไฟล์ PDF ใน Java