PDF'ye Ek Açıklamalar Nasıl Eklenir?

PDF’ye Ek Açıklamalar Nasıl Eklenir?

Belgelerde yazılan içeriği özetlemek ve kritik noktaları ve diğer ayrıntıları not etmek için bir PDF dosyasına metin açıklamaları eklersiniz. Ancak belgenin herhangi bir yerine metin açıklamaları ekleyebilirsiniz ve bir kez oluşturulduktan sonra açılır pencere olarak, kapatıldığında ise simge olarak görünür. Bu blog yazısında, PDF için bu Java API‘yi kullanarak bir PDF dosyasına nasıl ek açıklamalar ekleyeceğinizi öğreneceksiniz. Ek olarak, program aracılığıyla bir dosyaya metin açıklamaları eklemenize yardımcı olacak yöntemleri de öğreneceksiniz.

Bu kılavuzda aşağıdaki hususlar ele alınacaktır:

PDF için Java API - kurulum

Bu kütüphanenin kurulum prosedürü sadece bir adım uzakta. API’yi indirebilir veya aşağıdaki Maven yapılandırmalarını kullanarak yükleyebilirsiniz.

 <repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>
<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-pdf</artifactId>
    <classifier>jdk17</classifier>
</dependency>

PDF’ye ek açıklamalar nasıl eklenir

Artık, bir PDF dosyasına programlı olarak metin açıklaması eklemeyi uygulamak için bu PDF kitaplığının yöntemlerinden yararlanabilirsiniz.

Lütfen kod pasajını ve aşağıda belirtilen adımları izleyin:

  1. Document sınıfının bir örneğini oluşturun ve kaynak PDF dosyasını yükleyin.
  2. getItem yöntemini çağırarak dizine göre bir sayfa alın.
  3. Bir dikdörtgeni temsil eden Rectangle sınıfının bir nesnesini başlatın.
  4. TextAnnotation sınıfının bir nesnesini oluşturarak belirtilen sayfada yeni bir metin açıklaması oluşturun.
  5. setTitle yöntemi, ek açıklamanın başlık çubuğunda görüntülenecek metni ayarlar.
  6. setSubject yöntemi, nesnenin açıklamasını temsil eden metni ayarlar.
  7. setContents yöntemi ek açıklama metnini ayarlar.
  8. Border nesnesinin yapıcısını textAnnotation nesnesiyle örnekleyin.
  9. setWidth ve setDash yöntemlerini çağırarak kenarlık ve çizgi deseninin genişliğini ayarlayın.
  10. Koleksiyona ek açıklama ekleyen add yöntemini çağırın.
  11. save yöntemi açıklama dosyasını kaydedecektir.

Aşağıdaki kodu kopyalayıp ana dosyanıza yapıştırın:

// Document sınıfının bir örneğini oluşturun ve kaynak PDF dosyasını yükleyin.
Document document = new Document(  "table.pdf");
// get_Item yöntemini çağırarak dizine göre bir sayfa alın 
Page page = document.getPages().get_Item(1);
// Dikdörtgeni temsil eden Rectangle sınıfının bir nesnesini başlatın.
Rectangle rect = new Rectangle(200, 750, 400, 790);
// TextAnnotation sınıfının bir nesnesini oluşturarak belirtilen sayfada yeni bir Metin ek açıklaması oluşturun. 
TextAnnotation textAnnotation = new TextAnnotation(page, rect);
// setTitle yöntemi, ek açıklamanın başlık çubuğunda görüntülenecek metni ayarlar. 
textAnnotation.setTitle("Aspose User");
// setSubject yöntemi, nesnenin açıklamasını temsil eden metni ayarlar. 
textAnnotation.setSubject("Sample Subject");
// setContents yöntemi ek açıklama metnini ayarlar. 
textAnnotation.setContents("Sample contents for the annotation");
textAnnotation.setOpen(true);
textAnnotation.setIcon(TextIcon.Circle);
// textAnnotation nesnesiyle kenarlık nesnesinin yapıcısını başlatın. 
Border border = new Border(textAnnotation);
// setWidth ve setDash yöntemini çağırarak kenarlık ve çizgi deseninin genişliğini ayarlayın.  
border.setWidth(5);
border.setDash(new Dash(1, 1));
textAnnotation.setBorder(border);
textAnnotation.setRect(rect);
// Koleksiyona ek açıklama ekleyen add yöntemini çağırın. 
page.getAnnotations().add(textAnnotation);
// save yöntemi ek açıklama dosyasını kaydedecektir. 
document.save(  "sample_textannot.pdf");

Çıktıyı aşağıdaki resimde görebilirsiniz:

metin açıklaması

Metin açıklamalarını okuyun

Benzer şekilde, aşağıda belirtilen adımları izleyerek metin açıklamalarını mevcut bir PDF dosyasından okuyabiliriz:

  1. Document sınıfının bir örneğini oluşturun ve kaynak PDF dosyasını yükleyin.
  2. Dizine göre bir sayfa almak için getItem yöntemini çağırın.
  3. Açıklamaları AnnotationSelector kullanarak filtreleyin.
  4. Ziyaretçinin ek açıklamayı işlemesini kabul etmek için accept yöntemini çağırın.
  5. Seçilen Ek Açıklama nesnelerinin listesini almak için getSelected yöntemini çağırın.
  6. Sonuçları yazdırın.

Aşağıdaki kodu kopyalayıp ana dosyanıza yapıştırın:

// Document sınıfının bir örneğini oluşturun ve kaynak PDF dosyasını yükleyin. 
Document document = new Document(  "sample_textannot.pdf");
// Bir sayfayı dizine göre almak için get_Item yöntemini çağırarak çağırın.   
Page page = document.getPages().get_Item(1);
// AnnotationSelector'ı kullanarak ek açıklamaları filtreleyin 
AnnotationSelector annotationSelector = new AnnotationSelector(
        new TextAnnotation(page, Rectangle.getTrivial()));
// Ek açıklamayı işlemek üzere ziyaretçiyi kabul etmek için kabul yöntemini çağırın. 
page.accept(annotationSelector);
//  Seçilen Ek Açıklama nesnelerinin listesini almak için getSelected yöntemini çağırın. 
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// sonuçları yazdır
for (Annotation fa : TextAnnotations) {
    System.out.println(fa.getRect());
}

Metin açıklamalarını silin

Ayrıca metin açıklamalarını programlı olarak silmek için adımları ve kod pasajını takip edebilirsiniz:

  1. Document sınıfının bir nesnesini oluşturun ve kaynak PDF dosyasını yükleyin.
  2. Açıklamaları AnnotationSelector kullanarak filtreleyin.
  3. accept yöntemini çağırarak ziyaretçinin ek açıklamayı işlemesini kabul edin.
  4. Seçilen Ek Açıklama nesnelerinin listesini almak için getSelected yöntemini çağırın.
  5. Tüm metin açıklamaları arasında dolaşın ve delete yöntemini çağırarak açıklamaları silin.
  6. Dosyayı kaydetmek için save yöntemini çağırın.

Aşağıdaki kodu kopyalayıp ana dosyanıza yapıştırın:

// Document sınıfının bir nesnesini oluşturun ve kaynak PDF dosyasını yükleyin. 
Document document = new Document(  "sample_textannot.pdf");
// AnnotationSelector'ı kullanarak ek açıklamaları filtreleyin 
Page page = document.getPages().get_Item(1);
AnnotationSelector annotationSelector = new AnnotationSelector(
        new TextAnnotation(page, Rectangle.getTrivial()));
// Kabul yöntemini çağırarak ziyaretçinin ek açıklamayı işlemesini kabul eder 
page.accept(annotationSelector);
// Seçilen Ek Açıklama nesnelerinin listesini almak için getSelected yöntemini çağırın. 
List<Annotation> TextAnnotations = annotationSelector.getSelected();
// tüm metin açıklamaları arasında dolaşın
for (Annotation fa : TextAnnotations) {
    // Silme yöntemini çağırarak ek açıklamayı silin 
}
// Dosyayı kaydetmek için kaydetme yöntemini çağırın 
document.save ( "sample_textannot_del.pdf");

Ücretsiz Lisans Alın

API’yi değerlendirme sınırlamaları olmadan denemek için ücretsiz geçici lisans’tan yararlanabilirsiniz.

Özetliyor

Bu bizi bu blog yazısının sonuna getiriyor. Program aracılığıyla bir PDF dosyasına ek açıklamaların nasıl ekleneceğini anlattınız. Ayrıca, PDF için bu Java API’yi kullanarak mevcut PDF belgelerinden metin açıklamalarını nasıl okuyacağınızı ve sileceğinizi de öğrendiniz. Ayrıca, API yöntemlerini daha detaylı incelemek için belgeleri ziyaret edebilirsiniz.

Ayrıca Başlangıç kılavuzumuzu takip etmenizi öneririz.

Son olarak conholdate.com yeni blog yazıları yazıyor. Bu nedenle, düzenli güncellemeler için lütfen iletişim halinde kalın.

Bir soru sor

Sorularınızı veya sorularınızı forumumuzda bize bildirebilirsiniz.

SSS

Bir PDF’ye ücretsiz olarak açıklama ekleyebilir miyim?

PDF için Java API tarafından sunulan kod pasajını ve API yöntemlerini öğrenmek için lütfen bu bağlantı‘yı ziyaret edin.

Ayrıca bakınız