iText - Daire Açıklama

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

PDF'de Daire Açıklama Oluşturma

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

PDF belgenizde metin ek açıklamasını kullanmak için, PdfTextAnnotation sınıfının bir nesnesini oluşturmanız ve bunu 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.

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

// Creating a PdfWriter 
String dest = "C:/itextExamples/circleAnnotation.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 PDF Belgesini 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 ve olay işleyici 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, PdfDocument sınıfının bir nesnesini kabul eder.

Örnekleyin Document sınıfın nesnesini ileterek sınıf 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 tüm ek açıklamaların üst sınıfını temsil eder.

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

// Creating a PdfCircleAnnotation object Rectangle 
rect = new Rectangle(150, 770, 50, 50); 
PdfAnnotation annotation = new PdfCircleAnnotation(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.YELLOW);

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 sırasıyla sınıf.

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

// Setting contents of the annotation 
annotation.setContents(new PdfString("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ını seçin ve yukarıda oluşturulan notu kullanarak addAnnotation() PdfPage sınıfının yöntemi aşağıda gösterildiği gibi.

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

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

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 daire ek açıklamasının nasıl ekleneceğini gösterir. Adıyla bir PDF belgesi oluştururcircleAnnotation.pdf, ona bir daire ek açıklaması ekler ve bunu yola kaydeder C:/itextExamples/

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

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

javac PdfCircleAnnotation.java 
java PdfCircleAnnotation

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.