iText - Kreisanmerkung

In diesem Kapitel erfahren Sie, wie Sie einem PDF-Dokument mithilfe der iText-Bibliothek Kreisanmerkungen hinzufügen.

Erstellen einer Kreisanmerkung in einem PDF

Sie können ein leeres PDF-Dokument erstellen, indem Sie das instanziieren DocumentKlasse. Während Sie diese Klasse instanziieren, müssen Sie a bestehenPdfDocument Objekt als Parameter für seinen Konstruktor.

Um Textanmerkungen in Ihrem PDF-Dokument zu verwenden, müssen Sie ein Objekt der PdfTextAnnotation-Klasse erstellen und dieses zum hinzufügen Pdfpage.

Im Folgenden finden Sie die Schritte zum Verwenden von Textanmerkungen im PDF-Dokument.

Schritt 1: Erstellen eines PdfWriter-Objekts

Das PdfWriterKlasse repräsentiert den DocWriter für ein PDF. Diese Klasse gehört zum Paketcom.itextpdf.kernel.pdf. Der Konstruktor dieser Klasse akzeptiert eine Zeichenfolge, die den Pfad der Datei darstellt, in der die PDF erstellt werden soll.

Instanziieren Sie die PdfWriter Klasse, indem ein Zeichenfolgenwert (der den Pfad darstellt, in dem Sie eine PDF-Datei erstellen müssen) an den Konstruktor übergeben wird (siehe Abbildung unten).

// Creating a PdfWriter 
String dest = "C:/itextExamples/circleAnnotation.pdf"; 
PdfWriter writer = new PdfWriter(dest);

Wenn ein Objekt dieses Typs an ein PdfDocument (Klasse) übergeben wird, wird jedes zu diesem Dokument hinzugefügte Element in die angegebene Datei geschrieben.

Schritt 2: Erstellen eines PdfDocument-Objekts

Das PdfDocumentKlasse ist die Klasse, die das PDF-Dokument in iText darstellt. Diese Klasse gehört zum Paketcom.itextpdf.kernel.pdf. Um diese Klasse zu instanziieren (im Schreibmodus), müssen Sie ein Objekt der Klasse übergebenPdfWriter zu seinem Konstruktor.

Instanziieren Sie die PdfDocument-Klasse, indem Sie das PdfWriter-Objekt wie unten gezeigt an seinen Konstruktor übergeben.

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

Sobald ein PdfDocument-Objekt erstellt wurde, können Sie verschiedene Elemente wie Seite, Schriftart, Dateianhang und Ereignishandler mit den entsprechenden Methoden seiner Klasse hinzufügen.

Schritt 3: Erstellen des Dokumentobjekts

Das Document Klasse des Pakets com.itextpdf.layoutist das Stammelement beim Erstellen einer autarken PDF-Datei. Einer der Konstruktoren dieser Klasse akzeptiert ein Objekt der Klasse PdfDocument.

Instanziieren Sie die Document Klasse durch Übergeben des Objekts der Klasse PdfDocument in den vorherigen Schritten erstellt, wie unten gezeigt.

// Creating a Document  
Document document = new Document(pdfDoc);

Schritt 4: Erstellen eines PdfAnnotation-Objekts

Das PdfAnnotation Klasse des Pakets com.itextpdf.kernel.pdf.annot repräsentiert die Oberklasse aller Anmerkungen.

Unter seinen abgeleiteten Klassen, PdfCircleAnnotationKlasse repräsentiert die Kreisanmerkung. Erstellen Sie ein Objekt dieser Klasse wie unten gezeigt.

// Creating a PdfCircleAnnotation object Rectangle 
rect = new Rectangle(150, 770, 50, 50); 
PdfAnnotation annotation = new PdfCircleAnnotation(rect);

Schritt 5: Festlegen der Farbe der Anmerkung

Stellen Sie die Farbe mit der Taste auf die Anmerkung ein setColor() Methode der PdfAnnotationKlasse. Übergeben Sie bei dieser Methode das Farbobjekt, das die Farbe der Anmerkung darstellt, als Parameter.

// Setting color to the annotation 
annotation.setColor(Color.YELLOW);

Schritt 6: Festlegen des Titels und des Inhalts der Anmerkung

Stellen Sie den Titel und den Inhalt der Anmerkung mit der Taste ein setTitle() und setContents() Methoden der PdfAnnotation Klasse jeweils.

// Setting title to the annotation 
annotation.setTitle(new PdfString("circle annotation"));        

// Setting contents of the annotation 
annotation.setContents(new PdfString("Hi welcome to Tutorialspoint"));

Schritt 7: Hinzufügen der Anmerkung zu einer Seite

Erstelle eine neue PdfPage Klasse mit der addNewPage() Methode der PdfDocument Klasse und fügen Sie die oben erstellte Anmerkung mit dem hinzu addAnnotation() Methode der PdfPage-Klasse, wie unten gezeigt.

// Creating a new page 
PdfPage page = pdf.addNewPage();        

// Adding annotation to a page in a PDF 
page.addAnnotation(ann);

Schritt 8: Schließen des Dokuments

Schließen Sie das Dokument mit der close() Methode der Document Klasse, wie unten gezeigt.

// Closing the document 
document.close();

Beispiel

Das folgende Java-Programm zeigt, wie Sie mithilfe der iText-Bibliothek einem PDF-Dokument Kreisanmerkungen hinzufügen. Es wird ein PDF-Dokument mit dem Namen erstelltcircleAnnotation.pdf, fügt eine Kreisanmerkung hinzu und speichert sie im Pfad C:/itextExamples/

Speichern Sie diesen Code in einer Datei mit dem Namen PdfCircleAnnotation.java.

import com.itextpdf.kernel.color.Color; 
import com.itextpdf.kernel.geom.Rectangle; 
import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfPage;
import com.itextpdf.kernel.pdf.PdfString; 
import com.itextpdf.kernel.pdf.PdfWriter; 
import com.itextpdf.kernel.pdf.annot.PdfAnnotation; 
import com.itextpdf.kernel.pdf.annot.PdfCircleAnnotation; 
import com.itextpdf.layout.Document;  

public class CircleAnnotation {    
   public static void main(String args[]) throws Exception {   
      // Creating a PdfDocument object       
      String file = "C:/itextExamples// circleAnnotation.pdf";             
      PdfDocument pdf = new PdfDocument(new PdfWriter(file));                   
   
      // Creating a Document object       
      Document doc = new Document(pdf);                      
   
      // Creating a PdfCircleAnnotation object       
      Rectangle rect = new Rectangle(150, 770, 50, 50);       
      PdfAnnotation annotation = new PdfCircleAnnotation(rect);              
   
      // Setting color to the annotation       
      annotation.setColor(Color.YELLOW);              
   
      // Setting title to the annotation       
      annotation.setTitle(new PdfString("circle annotation"));              
   
      // Setting contents of the annotation 
      annotation.setContents(new PdfString("Hi welcome to Tutorialspoint"));             
      
      // Creating a new page        
      PdfPage page = pdf.addNewPage();              
      
      // Adding annotation to a page in a PDF       
      page.addAnnotation(annotation);                       
      
      // Closing the document       
      doc.close();  
      
      System.out.println("Annotation added successfully");       
   }   
}

Kompilieren Sie die gespeicherte Java-Datei und führen Sie sie an der Eingabeaufforderung mit den folgenden Befehlen aus:

javac PdfCircleAnnotation.java 
java PdfCircleAnnotation

Bei der Ausführung erstellt das obige Programm ein PDF-Dokument mit der folgenden Meldung.

Annotation added successfully

Wenn Sie den angegebenen Pfad überprüfen, finden Sie das erstellte PDF-Dokument wie unten gezeigt.