Dimentica di discutere il contenuto e il feedback dei documenti in lunghi thread di posta elettronica. Usa semplicemente le annotazioni per contrassegnare i documenti con messaggi e risposte. In questo articolo imparerai come aggiungere e rimuovere a livello di codice le annotazioni per contrassegnare i documenti di Word in C# con le tue applicazioni .NET.

Di seguito gli argomenti brevemente discussi:

API .NET per annotare e annotare file di Word

GroupDocs.Annotation fornisce l’API .NET per lavorare con le annotazioni per i tuoi documenti e immagini all’interno delle tue applicazioni .NET. L’API consente di aggiungere, rimuovere ed estrarre annotazioni dai documenti di Word. Inoltre, supporta fogli di calcolo, presentazioni, immagini, file PDF, pagine Web, messaggi di posta elettronica, disegni di Visio. Nell’elenco sono presenti anche alcuni disegni AutoCAD e formati di imaging digitale come DICOM. Per l’elenco completo dei formati di documento supportati per l’annotazione, puoi visitare la documentazione.

Scarica il programma di installazione delle DLL o MSI dalla sezione download o installa l’API nella tua applicazione .NET tramite NuGet. Puoi anche usare il seguente comando dal Package Manager.

PM> Install-Package GroupDocs.Annotation

Aggiungi annotazioni a Word in C#

Aggiungiamo alcuni dei diversi tipi di annotazioni ai documenti di Word. Esistono molti tipi diversi di annotazioni, quindi in questo articolo ne tratteremo solo alcuni.

Aggiungi annotazioni a DOC DOCX utilizzando l'API GroupDocs

Ci sono alcuni dei tipi di annotazioni supportati, puoi apprendere ogni annotazione individualmente.

  • Annotazione area / rettangolo
  • Freccia
  • Sottolineato
  • Filigrana
  • Distanza
  • Barrato
  • Campo di testo
  • Ellisse
  • Evidenziare
  • Collegamento
  • Punto
  • Polilinea
  • Sostituzione
  • Redazione delle risorse
  • Redazione del testo

Aggiungi annotazione freccia a Word usando C#

Di seguito sono riportati i passaggi per aggiungere l’annotazione della freccia a un documento di Word in C#.

Aggiungi annotazione freccia a livello di codice in Java e .NET
  • Carica il documento utilizzando la classe Annotator.
  • Inizializza l’annotazione della freccia con la classe ArrowAnnotation.
  • Regola la posizione, la dimensione, il numero di pagina dell’annotazione della freccia.
  • Aggiungi l’annotazione della freccia creata usando il metodo Aggiungi.
  • Salva il documento Word annotato nel percorso usando il metodo Salva.

Nell’esempio di codice seguente viene illustrato come aggiungere un’annotazione freccia a un documento di Word usando C#.

// Aggiungi l'annotazione della freccia ai documenti di Word usando 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");
}

Inserisci annotazione rettangolo o area in Word usando C#

Le personalizzazioni possono essere eseguite per qualsiasi annotazione aggiungendola al documento. Di seguito sono riportati i passaggi per aggiungere annotazioni a rettangolo o area a un documento DOC/DOCX con alcune personalizzazioni. È molto simile all’aggiunta di annotazioni Arrow, ma questa volta utilizza la classe AreaAnnotation.

  • Carica il documento DOC/DOCX utilizzando la classe Annotator.
  • Inizializza l’annotazione del rettangolo usando la classe AreaAnnotation.
  • Regola la posizione, le dimensioni e il colore del rettangolo.
  • Imposta altre proprietà come numero di pagina, sfondo, opacità, stile, larghezza penna, messaggi e ora.
  • Aggiungi l’annotazione rettangolare creata all’Annotator.
  • Salva il file annotato nel percorso usando il metodo Salva.
Aggiungi annotazione rettangolo o area a livello di codice in .NET e Java

Nell’esempio di codice seguente viene illustrato come aggiungere un’annotazione rettangolo/area a un documento di Word usando C#.

// Aggiungi annotazione area o rettangolo nei documenti di Word usando 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");
}

Aggiungi un’annotazione ovale o ellittica a Word usando C#

Di seguito sono riportati i passaggi per aggiungere annotazioni ovali o ellissi a un documento in C#.

Aggiungi ellissi o annotazione ovale in modo programmatico in C# .NET e Java
  • Carica il documento DOC/DOCX utilizzando la classe Annotator.
  • Inizializza l’annotazione dell’ellisse usando la classe EllipseAnnotation.
  • Impostare la posizione e la dimensione dell’annotazione dell’ellisse inizializzata.
  • Aggiungi l’annotazione dell’ellisse creata all’oggetto Annotator.
  • Fornisci il percorso e salva il file Word annotato usando il metodo Salva.

Nell’esempio di codice seguente viene illustrato come aggiungere un’annotazione ovale o ellittica a un documento di Word usando C#.

// Aggiungi annotazioni ovali o ellittiche nei documenti di Word usando 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");
}

Inserisci l’annotazione della distanza in Word usando C#

Allo stesso modo, puoi aggiungere l’annotazione della distanza per contrassegnare la distanza tra due punti. Di seguito sono riportati i passaggi per aggiungere l’annotazione della distanza al documento.

Aggiungi annotazione della distanza a livello di codice in C# .NET e Java
  • Dopo aver caricato il documento di Word, inizializzare l’annotazione della distanza utilizzando la classe DistanceAnnotation.
  • Imposta l’aspetto dell’annotazione.
  • Aggiungi l’annotazione della distanza all’oggetto Annotatore.
  • Salva i file di Word annotati nella posizione specificata specificando il percorso.

L’esempio di codice seguente mostra come aggiungere un’annotazione della distanza a un documento DOC/DOCX usando C#.

// Aggiungi l'annotazione della distanza ai documenti di Word usando 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");
}

Codice completo

Per riassumere, ecco il codice completo con l’output che mostra tutte le annotazioni e i messaggi aggiunti con risposte. Il codice C# seguente aggiunge frecce, rettangoli, ellissi, annotazioni di distanza, messaggi e risposte a un file di Word.

// Aggiungi più annotazioni a Word usando C#
// Aggiunta di annotazioni a freccia, area, ovale (ellisse), distanza a DOC/DOCX con messaggi e risposte utilizzando 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);
}

Rimuovere le annotazioni dai file Word DOC/DOCX utilizzando C#

Le annotazioni dai documenti possono essere rimosse facilmente. Ci sono molte opzioni per rimuovere le annotazioni da un documento di Word. Puoi rimuovere tutte le annotazioni contemporaneamente. Inoltre, puoi fornire gli indici per rimuovere le annotazioni specifiche. Per ulteriori opzioni, visita l’articolo documentazione.

Di seguito sono riportati i passaggi per rimuovere tutte le annotazioni da un file di Word.

  • Carica il documento.
  • Inizializza le opzioni di salvataggio usando la classe SaveOptions.
  • Imposta i tipi di annotazione su Nessuno.
  • Salva il file di Word. Non conterrà alcuna annotazione.

Il codice seguente mostra come rimuovere le annotazioni da un file di Word usando C#.

// Rimuovi tutte le annotazioni dal documento di Word usando C#
using (Annotator annotator = new Annotator(outputPath))
{
    annotator.Save(remOutputPath, new SaveOptions {AnnotationTypes = AnnotationType.None});
}

Conclusione

In breve, hai imparato come aggiungere annotazioni ai documenti di Word all’interno di applicazioni .NET usando C#. In particolare, abbiamo aggiunto annotazioni a freccia, ellisse, area e distanza al file Word DOC/DOCX. Inoltre, hai anche visto come rimuovere tutte le annotazioni da qualsiasi file di Word. Ora puoi pensare di creare la tua applicazione .NET di annotatore di documenti.

Ulteriori informazioni su GroupDocs.Annotation for .NET dalla documentazione e dal repository GitHub. Per ulteriori domande, contatta il supporto sul forum.

Guarda anche