iText - Satır Açıklaması

Bu bölümde, iText kitaplığını kullanarak bir PDF belgesine nasıl satır ek açıklaması ekleneceğini göreceğiz.

Pdf'de Satır Ek Açıklaması Oluşturma

Örneğini oluşturarak boş bir PDF Belgesi oluşturabilirsiniz. Documentsınıf. Bu sınıfı başlatırken, birPdfDocument nesneyi bir parametre olarak, yapıcısına.

PDF belgenizde metin ek açıklamasını kullanmak için bir nesne oluşturmanız gerekir. PdfTextAnnotation sınıf ve bunu ekleyin PdfPage.

Aşağıda, PDF belgesinde metin açıklamasını kullanma adımları verilmiştir.

Adım 1: Bir PdfWriter nesnesi oluşturma

PdfWritersınıfı, bir PDF için DocWriter'ı temsil eder. Bu sınıf pakete aittircom.itextpdf.kernel.pdf. Bu sınıfın yapıcısı, PDF'nin oluşturulacağı dosyanın yolunu temsil eden bir dizeyi kabul eder.

Aşağıda gösterildiği gibi, bir PDF oluşturmanız gereken yolu temsil eden bir dize değerini yapıcısına ileterek PdfWriter sınıfını örnekleyin.

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

Bu tür bir nesne bir PdfDocument'e (sınıf) aktarıldığında, bu belgeye eklenen her öğe belirtilen dosyaya yazılacaktır.

Adım 2: Bir PdfDocument nesnesi oluşturma

PdfDocumentclass, iText'teki PDFDocument'i temsil eden sınıftır. Bu sınıf pakete aittircom.itextpdf.kernel.pdf. Bu sınıfı başlatmak için (yazma modunda), sınıfın bir nesnesini iletmeniz gerekir.PdfWriter yapıcısına.

Aşağıda gösterildiği gibi, PdfWriter nesnesini yapıcısına ileterek PdfDocument sınıfını örnekleyin.

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

Bir PdfDocument nesnesi oluşturulduktan sonra, sınıfının sağladığı ilgili yöntemleri kullanarak sayfa, yazı tipi, dosya eki, olay işleyicisi gibi çeşitli öğeler ekleyebilirsiniz.

3. Adım: Belge nesnesini oluşturma

Document paketin sınıfı com.itextpdf.layoutkendi kendine yeten bir PDF oluştururken kullanılan kök öğedir. Bu sınıfın kurucularından biri sınıfın bir nesnesini kabul ederPdfDocument.

Sınıfın nesnesini ileterek Document sınıfının örneğini oluşturun PdfDocument aşağıda gösterildiği gibi önceki adımlarda oluşturulur.

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

Adım 4: PdfAnnotation nesnesi oluşturma

PdfAnnotation paketin sınıfı com.itextpdf.kernel.pdf.annot temsil eder, tüm ek açıklamaların üst sınıfıdır.

Türetilmiş sınıfları arasında, PdfLineAnnotationsınıf, satır açıklamasını temsil eder. Aşağıda gösterildiği gibi bu sınıfın bir nesnesini oluşturun.

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

Adım 5: Ek açıklamanın rengini ayarlama

Ek açıklamaya renk ayarlayın. setColor() yöntemi PdfAnnotationsınıf. Bu yönteme, ek açıklamanın rengini temsil eden renk nesnesini bir parametre olarak iletin.

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

Adım 6: Ek açıklamanın başlığını ve içeriğini ayarlama

Ek açıklamanın başlığını ve içeriğini ayarlayın. setTitle() ve setContents() yöntemleri PdfAnnotation aşağıda gösterildiği gibi sırasıyla sınıf.

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

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

7. Adım: Ek açıklamayı bir sayfaya ekleme

Yeni bir tane oluştur PdfPage kullanarak sınıf addNewPage() yöntemi PdfDocument sınıfına girin ve yukarıda gösterildiği gibi PdfPage sınıfının addAnnotation () yöntemini kullanarak yukarıda oluşturulan açıklamayı ekleyin.

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

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

8. Adım: Belgeyi Kapatma

Belgeyi kullanarak kapatın. close() yöntemi Document sınıf, aşağıda gösterildiği gibi.

// Closing the document 
document.close();

Misal

Aşağıdaki Java programı, iText kitaplığını kullanarak bir PDF belgesine satır ek açıklamasının nasıl ekleneceğini gösterir. Adıyla bir PDF belgesi oluştururlineAnnotation.pdf, ona bir satır ek açıklaması ekler ve bunu yola kaydeder C:/itextExamples/.

Bu kodu adıyla bir dosyaya kaydedin 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");   
   } 
}

Kaydedilen Java dosyasını aşağıdaki komutları kullanarak komut isteminden derleyin ve yürütün -

javac LineAnnotation.java 
java LineAnnotation

Yürütmenin ardından, yukarıdaki program aşağıdaki mesajı görüntüleyen bir PDF belgesi oluşturur.

Annotation added successfully

Belirtilen yolu doğrularsanız, oluşturulan PDF belgesini aşağıda gösterildiği gibi bulabilirsiniz.