Aggiungi annotazione collegamento
Aspose.PDF per .NET è una potente libreria che consente agli sviluppatori di eseguire varie operazioni PDF. Una di queste operazioni è l’aggiunta di annotazioni input penna ai documenti PDF. In questo articolo, forniremo una guida passo passo per spiegare il codice sorgente C# per aggiungere annotazioni input penna utilizzando Aspose.PDF per .NET. Iniziamo!
Comprensione della funzionalità di annotazione dell’input penna di Aspose.PDF per .NET
Prima di immergerci nel codice sorgente C#, comprendiamo innanzitutto cos’è l’annotazione input penna e i suoi usi.
Annotazione input penna è un modo per disegnare annotazioni input penna a mano libera sui documenti PDF. Ti consente di creare annotazioni con uno stilo o un mouse. Questa funzionalità è utile nelle situazioni in cui è necessario disegnare diagrammi, schizzi o altri tipi di annotazioni.
Passaggio 1: creazione di un nuovo documento
Il primo passaggio per aggiungere annotazioni input penna a un documento PDF è creare una nuova istanza della classe Document. Ciò si ottiene utilizzando il seguente frammento di codice:
string dataDir = "YOUR DATA DIRECTORY";
Document doc = new Document();
Page pdfPage = doc.Pages.Add();
Qui creiamo una nuova istanza della classe Document e vi aggiungiamo una nuova pagina.
Passaggio 2: creazione di annotazioni input penna
Il passaggio successivo consiste nel creare un’istanza della classe InkAnnotation. Questo viene fatto utilizzando il seguente frammento di codice:
System.Drawing.Rectangle drect = new System.Drawing.Rectangle();
drect.Height = (int)pdfPage.Rect.Height;
drect.Width = (int)pdfPage.Rect.Width;
drect.X = 0;
drect.Y = 0;
Aspose.Pdf.Rectangle arect = Aspose.Pdf.Rectangle.FromRect(drect);
IList<Point[]> inkList = new List<Point[]>();
Aspose.Pdf.Point[] arrpt = new Aspose.Pdf.Point[3];
inkList.Add(arrpt);
arrpt[0] = new Aspose.Pdf.Point(100, 800);
arrpt[1] = new Aspose.Pdf.Point(200, 800);
arrpt[2] = new Aspose.Pdf.Point(200, 700);
InkAnnotation ia = new InkAnnotation(pdfPage, arect, inkList);
ia.Title = "XXX";
ia.Color = Aspose.Pdf.Color.LightBlue; // (GetColorFromString(stroke.InkColor));
ia.CapStyle = CapStyle.Rounded;
Border border = new Border(ia);
border.Width = 25;
ia.Opacity = 0.5;
pdfPage.Annotations.Add(ia);
Qui, creiamo prima un rettangolo utilizzando la classe System.Drawing.Rectangle e lo convertiamo in Aspose.Pdf.Rectangle utilizzando il metodo FromRect. Creiamo quindi un’istanza della classe InkAnnotation utilizzando il rettangolo, un elenco di punti e la pagina in cui viene aggiunta l’annotazione.
Impostiamo quindi varie proprietà di InkAnnotation, come titolo, colore, stile del cappuccio, bordo e opacità. Infine, aggiungiamo l’annotazione alla pagina utilizzando il metodo Annotations.Add.
Passaggio 3: salvataggio del documento
Il passaggio finale consiste nel salvare il documento PDF con l’annotazione inchiostro aggiunta. Ciò si ottiene utilizzando il seguente frammento di codice:
dataDir = dataDir + "AddlnkAnnotation_out.pdf";
doc.Save(dataDir);
Qui, concateniamo il nome del file di output nella directory dei dati e salviamo il documento utilizzando il metodo Save.
Codice sorgente di esempio per l’aggiunta di annotazioni input penna utilizzando Aspose.PDF per .NET
// Il percorso della directory dei documenti.
string dataDir = "YOUR DATA DIRECTORY";
Document doc = new Document();
Page pdfPage = doc.Pages.Add();
System.Drawing.Rectangle drect = new System.Drawing.Rectangle();
drect.Height = (int)pdfPage.Rect.Height;
drect.Width = (int)pdfPage.Rect.Width;
drect.X = 0;
drect.Y = 0;
Aspose.Pdf.Rectangle arect = Aspose.Pdf.Rectangle.FromRect(drect);
IList<Point[]> inkList = new List<Point[]>();
Aspose.Pdf.Point[] arrpt = new Aspose.Pdf.Point[3];
inkList.Add(arrpt);
arrpt[0] = new Aspose.Pdf.Point(100, 800);
arrpt[1] = new Aspose.Pdf.Point(200, 800);
arrpt[2] = new Aspose.Pdf.Point(200, 700);
InkAnnotation ia = new InkAnnotation(pdfPage, arect, inkList);
ia.Title = "XXX";
ia.Color = Aspose.Pdf.Color.LightBlue; // (GetColorFromString(stroke.InkColor));
ia.CapStyle = CapStyle.Rounded;
Border border = new Border(ia);
border.Width = 25;
ia.Opacity = 0.5;
pdfPage.Annotations.Add(ia);
dataDir = dataDir + "AddlnkAnnotation_out.pdf";
// Salva il file di output
doc.Save(dataDir);
Conclusione
In questo tutorial, abbiamo esplorato come aggiungere annotazioni input penna a un documento PDF utilizzando Aspose.PDF per .NET. Seguendo la guida passo passo e il codice sorgente C# fornito, gli sviluppatori possono facilmente implementare la funzionalità di annotazione input penna nelle loro applicazioni di elaborazione PDF.
Domande frequenti
D: Cos’è un’annotazione input penna in un documento PDF?
R: Un’annotazione input penna in un documento PDF consente agli utenti di disegnare annotazioni input penna a mano libera utilizzando uno stilo o un mouse. Viene comunemente utilizzato per aggiungere schizzi disegnati a mano, diagrammi o altre annotazioni a mano libera a un PDF.
D: Posso personalizzare l’aspetto dell’annotazione inchiostro?
R: Sì, Aspose.PDF per .NET fornisce varie proprietà per personalizzare l’aspetto dell’annotazione inchiostro, come colore, opacità, stile del cappuccio, larghezza del bordo e altro. Gli sviluppatori possono modificare queste proprietà per soddisfare i loro requisiti specifici.
D: È possibile aggiungere più annotazioni input penna a una singola pagina PDF?
R: Sì, puoi aggiungere più annotazioni input penna a una singola pagina PDF utilizzando Aspose.PDF per .NET. Ogni annotazione inchiostro può avere il proprio set di punti e un aspetto personalizzato.
D: Posso aggiungere annotazioni input penna a documenti PDF esistenti?
R: Sì, Aspose.PDF per .NET ti consente di aggiungere annotazioni input penna sia ai documenti PDF appena creati che ai file PDF esistenti. È possibile aprire un PDF esistente, aggiungere annotazioni input penna e salvare il documento aggiornato.
D: Quali sono alcuni casi d’uso comuni per le annotazioni input penna nei documenti PDF?
R: Le annotazioni input penna sono utili per un’ampia gamma di applicazioni, tra cui l’aggiunta di firme o note scritte a mano ai moduli PDF, l’annotazione di progetti architettonici o disegni tecnici e la marcatura di documenti per la revisione collaborativa.