Oubliez de discuter du contenu des documents et des commentaires dans de longs fils de discussion. Utilisez simplement des annotations pour baliser les documents avec des messages et des réponses. Dans cet article, vous apprendrez à ajouter et à supprimer par programmation des annotations pour baliser des documents Word en C# avec vos applications .NET.

Voici les sujets abordés brièvement ci-dessous :

API .NET pour annoter et annoter des fichiers Word

GroupDocs.Annotation fournit l’API .NET pour travailler avec les annotations de vos documents et images dans vos applications .NET. L’API vous permet d’ajouter, de supprimer et d’extraire des annotations à partir de documents Word. En outre, il prend en charge les feuilles de calcul, les présentations, les images, les fichiers PDF, les pages Web, les messages électroniques et les dessins Visio. Certains dessins AutoCAD et formats d’imagerie numérique tels que DICOM figurent également sur la liste. Pour la liste complète des formats de document pris en charge pour l’annotation, vous pouvez consulter la documentation.

Téléchargez le programme d’installation DLLs ou MSI à partir de la section téléchargements ou installez l’API dans votre application .NET via NuGet. Vous pouvez également utiliser la commande suivante du gestionnaire de packages.

PM> Install-Package GroupDocs.Annotation

Ajouter des annotations à Word en C#

Ajoutons quelques-uns des différents types d’annotations aux documents Word. Il existe de nombreux types d’annotations différents, nous n’en couvrirons donc que quelques-uns dans cet article.

Ajouter des annotations à DOC DOCX à l'aide de l'API GroupDocs

Il existe certains des types d’annotations pris en charge, vous pouvez en savoir plus sur chaque annotation individuellement.

  • Annotation Zone / Rectangle
  • Flèche
  • Souligner
  • Filigrane
  • Distance
  • Barré
  • Champ de texte
  • Ellipse
  • Souligner
  • Lien
  • Indiquer
  • Polyligne
  • Remplacement
  • Rédaction des ressources
  • Rédaction de texte

Ajouter une annotation de flèche à Word à l’aide de C

Voici les étapes pour ajouter une annotation de flèche à un document Word en C#.

Ajouter une annotation de flèche par programmation dans Java et .NET
  • Chargez le document en utilisant la classe Annotator.
  • Initialiser l’annotation fléchée avec la classe ArrowAnnotation.
  • Ajustez la position, la taille, le numéro de page de l’annotation de la flèche.
  • Ajoutez l’annotation de flèche créée à l’aide de la méthode Add.
  • Enregistrez le document Word annoté dans le chemin à l’aide de la méthode Enregistrer.

L’exemple de code suivant montre comment ajouter une annotation de flèche à un document Word à l’aide de C#.

// Ajouter une annotation de flèche aux documents Word à l'aide de 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");
}

Insérer un rectangle ou une annotation de zone dans Word à l’aide de C#

Des personnalisations peuvent être effectuées pour n’importe quelle annotation lors de son ajout au document. Voici les étapes pour ajouter une annotation de rectangle ou de zone à un document DOC/DOCX avec quelques personnalisations. Cela ressemble beaucoup à l’ajout d’annotations Arrow mais utilise cette fois la classe AreaAnnotation.

  • Chargez le document DOC/DOCX en utilisant la classe Annotator.
  • Initialiser l’annotation du rectangle à l’aide de la classe AreaAnnotation.
  • Ajustez la position, la taille et la couleur du rectangle.
  • Définissez d’autres propriétés telles que numéro de page, arrière-plan, opacité, style, largeur du stylo, messages et heure.
  • Ajoutez l’annotation rectangulaire créée à l’annotateur.
  • Enregistrez le fichier annoté dans le chemin en utilisant la méthode Save.
Ajouter un rectangle ou une annotation de zone par programmation dans .NET et Java

L’exemple de code suivant montre comment ajouter une annotation de rectangle/zone à un document Word à l’aide de C#.

// Ajouter une annotation de zone ou de rectangle dans des documents Word à l'aide de 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");
}

Ajouter une annotation ovale ou ellipse à Word à l’aide de C#

Voici les étapes pour ajouter une annotation ovale ou une annotation ellipse à un document en C#.

Ajouter des ellipses ou des annotations ovales par programmation dans C# .NET et Java
  • Chargez le document DOC/DOCX en utilisant la classe Annotator.
  • Initialiser l’annotation d’ellipse à l’aide de la classe EllipseAnnotation.
  • Définissez la position et la taille de l’annotation d’ellipse initialisée.
  • Ajoutez l’annotation d’ellipse créée à l’objet Annotator.
  • Indiquez le chemin et enregistrez le fichier Word annoté en utilisant la méthode Save.

L’exemple de code suivant montre comment ajouter une annotation ovale ou elliptique à un document Word à l’aide de C#.

// Ajouter une annotation ovale ou ellipse dans des documents Word à l'aide de 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");
}

Insérer une annotation de distance dans Word à l’aide de C#

De même, vous pouvez ajouter l’annotation de distance pour marquer la distance entre deux points. Voici les étapes pour ajouter une annotation de distance au document.

Ajouter une annotation de distance par programmation dans C# .NET et Java
  • Après avoir chargé le document Word, initialisez l’annotation de distance à l’aide de la classe DistanceAnnotation.
  • Définissez l’apparence de l’annotation.
  • Ajoutez l’annotation de distance à l’objet Annotator.
  • Enregistrez les fichiers Word annotés à l’emplacement indiqué en spécifiant le chemin.

L’exemple de code suivant montre comment ajouter une annotation de distance à un document DOC/DOCX à l’aide de C#.

// Ajouter une annotation de distance aux documents Word à l'aide de 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");
}

Code complet

Pour résumer, voici le code complet avec la sortie montrant toutes les annotations et messages ajoutés avec les réponses. Le code C# suivant ci-dessous ajoute une flèche, un rectangle, une ellipse, des annotations de distance, des messages et des réponses à un fichier Word.

// Ajouter plusieurs annotations à Word à l'aide de C#
// Ajout d'annotations de flèche, de zone, d'ovale (ellipse) et de distance à DOC/DOCX avec des messages et des réponses à l'aide de 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);
}

Supprimer les annotations des fichiers Word DOC/DOCX à l’aide de C#

Les annotations des documents peuvent être supprimées facilement. Il existe de nombreuses options pour supprimer les annotations d’un document Word. Vous pouvez supprimer toutes les annotations à la fois. De plus, vous pouvez fournir les index pour supprimer les annotations spécifiques. Pour plus d’options, consultez l’article documentation.

Voici les étapes pour supprimer toutes les annotations d’un fichier Word.

  • Charger le document.
  • Initialiser les options d’enregistrement à l’aide de la classe SaveOptions.
  • Définissez les types d’annotations sur Aucun.
  • Enregistrez le fichier Word. Il n’y aura aucune annotation dedans.

Le code suivant montre comment supprimer des annotations d’un fichier Word à l’aide de C#.

// Supprimez toutes les annotations du document Word à l'aide de C #
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Conclusion

En bref, vous avez appris à ajouter des annotations aux documents Word dans les applications .NET à l’aide de C#. Plus précisément, nous avons ajouté des annotations de flèche, d’ellipse, de zone et de distance au fichier Word DOC/DOCX. De plus, vous avez également vu comment supprimer toutes les annotations de n’importe quel fichier Word. Maintenant, vous pouvez penser à créer votre propre application .NET d’annotateur de documents.

En savoir plus sur GroupDocs.Annotation pour .NET à partir de la documentation et du référentiel GitHub. Pour toute autre question, contactez le support sur le forum.

Voir également