Vergeet de inhoud en feedback van documenten te bespreken in lange e-mailthreads. Gebruik gewoon annotaties om documenten te markeren met berichten en antwoorden. In dit artikel leert u hoe u annotaties programmatisch kunt toevoegen en verwijderen om Word-documenten in C# te markeren met uw .NET-toepassingen.

Hieronder worden de volgende onderwerpen kort besproken:

.NET API om Word-bestanden te annoteren en te markeren

GroupDocs.Annotation biedt de .NET API om te werken met de annotaties voor uw documenten en afbeeldingen binnen uw .NET-toepassingen. Met de API kunt u annotaties uit Word-documenten toevoegen, verwijderen en extraheren. Verder ondersteunt het spreadsheets, presentaties, afbeeldingen, PDF-bestanden, webpagina’s, e-mailberichten, Visio-tekeningen. Sommige AutoCAD-tekeningen en digitale beeldformaten zoals DICOM staan ook op de lijst. Voor de volledige lijst van ondersteunde documentformaten voor annotatie kun je de documentatie bezoeken.

Download de DLL’s of het MSI-installatieprogramma van de downloadsectie of installeer de API in uw .NET-toepassing via NuGet. U kunt ook de volgende opdracht van de Pakketbeheerder gebruiken.

PM> Install-Package GroupDocs.Annotation

Annotaties toevoegen aan Word in C#

Laten we enkele van de verschillende soorten annotaties aan de Word-documenten toevoegen. Er zijn veel verschillende soorten annotaties, dus we zullen er in dit artikel slechts een paar behandelen.

Annotaties toevoegen aan DOC DOCX met behulp van GroupDocs API

Er zijn enkele van de ondersteunde annotatietypen, u kunt elke annotatie afzonderlijk leren kennen.

  • Annotatie gebied/rechthoek
  • Pijl
  • Onderstrepen
  • Watermerk
  • Afstand
  • Doorhalen
  • Tekst veld
  • Ovaal
  • Markeer
  • Koppeling
  • Punt
  • Polylijn
  • Vervanging
  • Redactie van bronnen
  • Tekstredactie

Pijlannotatie aan Word toevoegen met C#

Hieronder volgen de stappen om pijlannotatie toe te voegen aan een Word-document in C#.

Pijlannotatie programmatisch toevoegen in Java en .NET
  • Laad het document met behulp van de klasse Annotator.
  • Initialiseer pijlannotatie met de klasse ArrowAnnotation.
  • Pas de positie, het formaat en het paginanummer van de pijlannotatie aan.
  • Voeg de gemaakte pijlannotatie toe met de methode Toevoegen.
  • Sla het geannoteerde Word-document op in het pad met de methode Opslaan.

Het volgende codevoorbeeld laat zien hoe u met C# een pijlannotatie aan een Word-document kunt toevoegen.

// Pijlannotatie toevoegen aan Word-documenten met 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");
}

Rechthoek- of gebiedannotatie invoegen in Word met behulp van C#

Aanpassingen kunnen worden gedaan voor elke annotatie terwijl deze aan het document wordt toegevoegd. Hieronder volgen de stappen om rechthoek- of gebiedannotaties toe te voegen aan een DOC/DOCX-document met enkele aanpassingen. Het lijkt sterk op het toevoegen van Arrow-annotaties, maar gebruikt deze keer de klasse AreaAnnotation.

  • Laad het DOC/DOCX-document met behulp van de klasse Annotator.
  • Initialiseer rechthoekannotatie met behulp van de klasse AreaAnnotation.
  • Pas de positie, grootte en kleur van de rechthoek aan.
  • Stel andere eigenschappen in zoals paginanummer, achtergrond, dekking, stijl, penbreedte, berichten en tijd.
  • Voeg de gemaakte rechthoekannotatie toe aan de annotator.
  • Sla het geannoteerde bestand op in het pad met de methode Opslaan.
Voeg rechthoek- of gebiedannotatie programmatisch toe in .NET en Java

Het volgende codevoorbeeld laat zien hoe u rechthoek-/gebiedaantekeningen toevoegt aan een Word-document met behulp van C#.

// Gebieds- of rechthoekannotatie toevoegen in Word-documenten met 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");
}

Ovale of ellipsvormige annotatie aan Word toevoegen met C#

Hieronder volgen de stappen om ovale annotatie of ellipsannotatie toe te voegen aan een document in C#.

Ellipsen of ovale annotaties programmatisch toevoegen in C# .NET en Java
  • Laad het DOC/DOCX-document met de klasse Annotator.
  • Initialiseer ellipsannotatie met de klasse EllipseAnnotation.
  • Stel de positie en grootte van de geïnitialiseerde ellipsannotatie in.
  • Voeg de gemaakte ellipsannotatie toe aan het Annotator-object.
  • Geef het pad op en sla het geannoteerde Word-bestand op met de methode Opslaan.

Het volgende codevoorbeeld laat zien hoe u ovale of ellipsvormige annotaties kunt toevoegen aan een Word-document met behulp van C#.

// Ovale of ellipsvormige annotatie toevoegen in Word-documenten met 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");
}

Afstandsannotatie invoegen in Word met behulp van C#

Op dezelfde manier kunt u de annotatie voor de afstand toevoegen om de afstand tussen twee punten te markeren. Hieronder volgen de stappen om annotaties op afstand toe te voegen aan het document.

Afstandsannotatie programmatisch toevoegen in C# .NET en Java
  • Nadat u het Word-document hebt geladen, initialiseert u de annotatie op afstand met behulp van de klasse DistanceAnnotation.
  • Stel het uiterlijk van de annotatie in.
  • Voeg de annotatie voor de afstand toe aan het Annotator-object.
  • Sla de geannoteerde Word-bestanden op de opgegeven locatie op door het pad op te geven.

Het volgende codevoorbeeld laat zien hoe u afstandsannotatie kunt toevoegen aan een DOC/DOCX-document met behulp van C#.

// Annotatie op afstand toevoegen aan Word-documenten met 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");
}

Volledige code

Samengevat, hier is de volledige code met de uitvoer die alle toegevoegde annotaties en berichten met antwoorden toont. De volgende C#-code hieronder voegt pijl-, rechthoek-, ellips-, afstands-annotaties, berichten en antwoorden toe aan een Word-bestand.

// Voeg meerdere annotaties toe aan Word met C#
// Annotaties voor pijl, gebied, ovaal (ellips), afstand toevoegen aan DOC/DOCX met berichten en antwoorden met behulp van 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);
}

Annotaties verwijderen uit Word DOC/DOCX-bestanden met C#

Annotaties uit de documenten kunnen eenvoudig worden verwijderd. Er zijn veel opties om de annotaties uit een Word-document te verwijderen. U kunt alle annotaties in één keer verwijderen. Bovendien kunt u de indexen opgeven om de specifieke annotaties te verwijderen. Ga voor meer opties naar het artikel documentatie.

Hieronder volgen de stappen om alle annotaties uit een Word-bestand te verwijderen.

  • Laad het document.
  • Initialiseer opslagopties met de klasse SaveOptions.
  • Stel de annotatietypen in op Geen.
  • Sla het Word-bestand op. Er zal geen annotatie in staan.

De volgende code laat zien hoe annotaties uit een Word-bestand kunnen worden verwijderd met behulp van C#.

// Verwijder alle annotaties uit het Word-document met C#
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Conclusie

Kortom, je hebt geleerd hoe je met C# annotaties kunt toevoegen aan Word-documenten binnen .NET-applicaties. We hebben met name pijl-, ellips-, oppervlakte- en afstandsannotaties toegevoegd aan het Word DOC/DOCX-bestand. Verder heb je ook gezien hoe je alle annotaties uit elk Word-bestand kunt verwijderen. Nu kunt u overwegen om uw eigen documentannotator .NET-toepassing te bouwen.

Meer informatie over GroupDocs.Annotation for .NET vindt u in de documentatie en de GitHub-repository. Neem voor verdere vragen contact op met de ondersteuning op het forum.

Zie ook