Niente più lunghe discussioni all’interno di lunghi thread di posta elettronica sul contenuto dei documenti. Puoi utilizzare le annotazioni per contrassegnare documenti con messaggi personalizzati e relative risposte. Questo articolo illustra come annotare a livello di codice i file PDF per contrassegnare i documenti usando C#. Inoltre, discuteremo anche di come rimuovere le annotazioni dai file PDF.
Di seguito vengono discussi brevemente i seguenti argomenti:
API .NET per annotare i file PDF
GroupDocs.Annotation ha la sua API .NET per lavorare con le annotazioni all’interno di documenti e immagini. Ti consente di aggiungere, rimuovere ed estrarre annotazioni da documenti PDF e Word, fogli di calcolo e presentazioni. Inoltre, supporta immagini, pagine Web, messaggi di posta elettronica, disegni di Visio e molto altro. Puoi dare un’occhiata alla documentazione per l’elenco completo dei formati di documento supportati per le annotazioni.
Scarica le sue DLL o MSI installer 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 al PDF usando C#
Ci sono molti diversi tipi di annotazioni che possono essere aggiunte all’interno dei documenti, tuttavia ne discuteremo solo alcune in questo articolo.
Di seguito sono riportate alcune delle annotazioni supportate. Puoi apprendere ogni annotazione individualmente.
- Annotazione area / rettangolo
- Freccia
- Distanza
- Ellisse
- Evidenziare
- Collegamento
- Punto
- Polilinea – Sostituzione
- Redazione delle risorse
- Barrato
- Campo di testo
- Redazione del testo
- Sottolineato
- Filigrana
Aggiungi annotazione freccia al PDF usando C#
Di seguito sono riportati i passaggi su come aggiungere annotazioni freccia ai documenti PDF in C#.
- Carica il documento PDF utilizzando la classe Annotator.
- Inizializzare Anrow Annotation.
- Definire la posizione, la dimensione, il numero di pagina dell’annotazione della freccia.
- Aggiungi l’annotazione della freccia definita utilizzando il metodo Aggiungi.
- Salvare il documento annotato utilizzando il metodo appropriato Save().
L’esempio di codice C# seguente mostra come aggiungere un’annotazione freccia a un documento PDF.
// Aggiungi l'annotazione della freccia ai documenti PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
ArrowAnnotation arrow = new ArrowAnnotation
{
Box = new Rectangle(100, 100, 50, 50),
// facoltativo --
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.pdf");
}
Inserisci annotazione rettangolo o area in PDF usando C#
Di seguito sono riportati i passaggi per aggiungere un rettangolo o un’area annotazione a un documento PDF con alcune personalizzazioni. È molto simile all’aggiunta di annotazioni Arrow ma utilizza AreaAnnotation.
- Carica il documento PDF utilizzando la classe Annotator.
- Inizializzare l’annotazione del rettangolo utilizzando la classe AreaAnnotation.
- Specificare la posizione, la dimensione e il colore del rettangolo.
- Puoi anche impostare altre proprietà come numero di pagina, sfondo, opacità, stile, larghezza penna, messaggi e ora.
- Aggiungi l’annotazione rettangolo definito all’Annotator.
- Infine, salva il file annotato utilizzando il metodo Save().
L’esempio di codice seguente aggiunge un’annotazione rettangolo/area a un documento PDF usando C#.
// Aggiungi annotazione area o rettangolo nei documenti PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
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.pdf");
}
Aggiungi annotazione ovale o ellisse al PDF usando C#
Allo stesso modo, aggiungiamo l’annotazione ellisse/ovale. I passaggi seguenti mostrano come aggiungere un’annotazione ovale o ellisse a un file PDF utilizzando C#.
- Carica il file PDF utilizzando la classe Annotator.
- Inizializza Ellisse Annotation.
- Impostare la posizione, la dimensione e altre proprietà dell’annotazione inizializzata.
- Aggiungi l’annotazione dell’ellisse creata all’oggetto Annotator.
- Utilizzare il metodo Save() per salvare il file PDF annotato.
L’esempio di codice C# seguente aggiunge un’annotazione ovale/ellisse a un documento PDF.
// Aggiungi annotazioni ovali o ellittiche nei documenti PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
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.pdf");
}
Inserisci l’annotazione della distanza in PDF usando C#
È possibile utilizzare l’annotazione della distanza per evidenziare la distanza tra due oggetti. Di seguito sono riportati i passaggi che aggiungono l’annotazione della distanza al documento PDF utilizzando C#.
- Dopo aver caricato il documento PDF utilizzando la classe Annotator, inizializzare l’annotazione della distanza utilizzando [DistanceAnnotation](https://apiference.groupdocs. com/annotation/net/groupdocs.annotation.models.annotationmodels/distanceannotation).
- Imposta l’aspetto, il colore della linea, lo spessore, lo stile, ecc.
- Aggiungi l’annotazione della distanza all’Annotatore.
- Salva il file PDF con l’annotazione utilizzando il metodo appropriato Save().
Il frammento di codice seguente mostra come aggiungere l’annotazione della distanza all’interno del PDF usando C#.
// Aggiungi l'annotazione della distanza ai documenti PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
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.pdf");
}
Rimuovere le annotazioni dai file PDF utilizzando C#
Esistono diversi modi per rimuovere le annotazioni dai documenti PDF. In entrambi i casi puoi rimuovere tutte le annotazioni in una volta oppure puoi fornire ID, indici per rimuovere quelle selettive. Abbiamo discusso i diversi modi per rimuovere le annotazioni in un articolo separato. Tuttavia, ecco i passaggi per rimuovere tutte le annotazioni da un file PDF.
- Carica il documento.
- Inizializzare le Opzioni di salvataggio.
- Imposta i tipi di annotazione su Nessuno.
- Salva il file PDF senza annotazioni utilizzando il metodo Save().
Il codice C# seguente mostra come rimuovere le annotazioni dai file PDF.
// Rimuovi tutte le annotazioni dal documento PDF usando C#
using (Annotator annotator = new Annotator("path/document.pdf"))
{
annotator.Save("path/document-noAnnotation.pdf", new SaveOptions {AnnotationTypes = AnnotationType.None});
}
Conclusione
Per concludere, hai imparato come aggiungere diverse annotazioni ai documenti PDF all’interno delle applicazioni .NET usando C#. Più precisamente, abbiamo aggiunto annotazioni di frecce, ellissi, aree e distanze. Inoltre, hai anche visto uno dei modi per rimuovere tutte le annotazioni da qualsiasi file PDF.
Puoi pensare di creare la tua applicazione .NET di annotatore di documenti. Per ulteriori informazioni su GroupDocs.Annotation for .NET, visitare la documentazione e GitHub. Per ulteriori domande, contatta il supporto sul forum.