iText - opis linii

W tym rozdziale zobaczymy, jak dodać adnotację liniową do dokumentu PDF za pomocą biblioteki iText.

Tworzenie opisu linii w pliku PDF

Możesz utworzyć pusty dokument PDF, tworząc wystąpienie Documentklasa. Podczas tworzenia instancji tej klasy musisz przekazać plikPdfDocument obiekt jako parametr do jego konstruktora.

Aby użyć adnotacji tekstowej w dokumencie PDF, musisz utworzyć obiekt PdfTextAnnotation klasy i dodaj to do PdfPage.

Poniżej przedstawiono kroki, aby użyć adnotacji tekstowych w dokumencie PDF.

Krok 1: Tworzenie obiektu PdfWriter

Plik PdfWriterreprezentuje DocWriter dla pliku PDF. Ta klasa należy do pakietucom.itextpdf.kernel.pdf. Konstruktor tej klasy akceptuje ciąg znaków reprezentujący ścieżkę do pliku, w którym ma zostać utworzony plik PDF.

Utwórz wystąpienie klasy PdfWriter, przekazując wartość ciągu reprezentującą ścieżkę, w której należy utworzyć plik PDF, do jej konstruktora, jak pokazano poniżej.

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

Gdy obiekt tego typu jest przekazywany do PdfDocument (klasy), każdy element dodany do tego dokumentu zostanie zapisany w określonym pliku.

Krok 2: Tworzenie obiektu PdfDocument

Plik PdfDocumentclass to klasa reprezentująca PDFDocument w iText. Ta klasa należy do pakietucom.itextpdf.kernel.pdf. Aby utworzyć instancję tej klasy (w trybie pisania), musisz przekazać obiekt tej klasyPdfWriter do swojego konstruktora.

Utwórz wystąpienie klasy PdfDocument, przekazując obiekt PdfWriter do jej konstruktora, jak pokazano poniżej.

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

Po utworzeniu obiektu PdfDocument możesz dodać różne elementy, takie jak strona, czcionka, załącznik do pliku, moduł obsługi zdarzeń, używając odpowiednich metod dostarczonych przez jego klasę.

Krok 3: Tworzenie obiektu dokumentu

Plik Document klasa pakietu com.itextpdf.layoutjest elementem głównym podczas tworzenia samowystarczalnego pliku PDF. Jeden z konstruktorów tej klasy akceptuje obiekt tej klasyPdfDocument.

Utwórz wystąpienie klasy Document, przekazując obiekt tej klasy PdfDocument utworzone w poprzednich krokach, jak pokazano poniżej.

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

Krok 4: Tworzenie obiektu PdfAnnotation

Plik PdfAnnotation klasa pakietu com.itextpdf.kernel.pdf.annot reprezentuje to nadklasa wszystkich adnotacji.

Wśród jego klas pochodnych PdfLineAnnotationklasa reprezentuje opis linii. Utwórz obiekt tej klasy, jak pokazano poniżej.

// Creating PdfAnnotation 
Rectangle rect = new Rectangle(20, 800, 0, 0); 
PdfAnnotation annotation = new PdfLineAnnotation(rect);

Krok 5: Ustawianie koloru adnotacji

Ustaw kolor adnotacji za pomocą setColor() metoda PdfAnnotationklasa. Do tej metody przekaż obiekt color reprezentujący kolor adnotacji jako parametr.

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

Krok 6: Ustawianie tytułu i treści adnotacji

Ustaw tytuł i zawartość adnotacji za pomocą setTitle() i setContents() metody PdfAnnotation klasę odpowiednio, jak pokazano poniżej.

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

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

Krok 7: Dodanie adnotacji do strony

Stwórz nowy PdfPage klasa przy użyciu addNewPage() metoda PdfDocument class i dodaj utworzoną powyżej adnotację za pomocą metody addAnnotation () klasy PdfPage, jak pokazano poniżej.

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

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

Krok 8: Zamknięcie dokumentu

Zamknij dokument za pomocą close() metoda Document klasa, jak pokazano poniżej.

// Closing the document 
document.close();

Przykład

Poniższy program w języku Java przedstawia sposób dodawania adnotacji wierszowych do dokumentu PDF za pomocą biblioteki iText. Tworzy dokument PDF o nazwielineAnnotation.pdf, dodaje do niego opis linii i zapisuje go w ścieżce C:/itextExamples/.

Zapisz ten kod w pliku o nazwie LineAnnotation.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.PdfLineAnnotation; 
import com.itextpdf.layout.Document;  

public class LineAnnotation {
   public static void main(String args[]) throws Exception {             
      // Creating a PdfWriter       
      String dest = "C:/itextExamples/lineAnnotations.pdf";       
      PdfWriter writer = new PdfWriter(dest);               

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

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

      // creating PdfLineAnnotation object       
      Rectangle rect = new Rectangle(0, 0);
      float[] floatArray  = new float[]{
         20, 790, page.getPageSize().getWidth() - 20, 790
      };
      PdfAnnotation annotation = new PdfLineAnnotation(rect, floatArray);              
      
      // Setting color of the PdfLineAnnotation       
      annotation.setColor(Color.BLUE);              
      
      // Setting title to the PdfLineAnnotation       
      annotation.setTitle(new PdfString("iText"));              
      
      // Setting contents of the PdfLineAnnotation       
      annotation.setContents("Hi welcome to Tutorialspoint");              
      
      // Adding annotation to the page       
      page.addAnnotation(annotation);               
      
      // Closing the document       
      document.close();              
      
      System.out.println("Annotation added successfully");   
   } 
}

Skompiluj i uruchom zapisany plik Java z wiersza poleceń, używając następujących poleceń -

javac LineAnnotation.java 
java LineAnnotation

Po uruchomieniu powyższy program tworzy dokument PDF z następującym komunikatem.

Annotation added successfully

Jeśli zweryfikujesz określoną ścieżkę, możesz znaleźć utworzony dokument PDF, jak pokazano poniżej.