Birden çok eki ve farklı dosya sürümleri olan uzun e-posta dizilerinde belge içeriğini ve geri bildirimleri tartıştığımız bir zaman vardı. Artık belgeyi mesajlar ve yanıtlarla işaretlemek ve göndermek için ek açıklamaları kullanabiliriz. Bu makalede, uygulamanızla Java’da PDF belgelerine programlı olarak nasıl açıklama ekleyeceğinizi öğreneceksiniz. Ek olarak, aynı Java API’sini kullanarak açıklamaların PDF dosyalarından nasıl kaldırılacağını göreceğiz.
Aşağıda kısaca tartışılan konular şunlardır:
- PDF’deki Ek Açıklamalarla Çalışmak için Java API
- Java’da PDF’ye Ek Açıklamalar Ekleyin
- Java’da Ek Açıklamaları PDF’den Kaldırma
PDF Annotator Java API
Belgenizin ek açıklamalarıyla ve Java uygulamalarınızdaki resimlerle başa çıkmak için GroupDocs, GroupDocs.Annotation for Java sağlar. API’yi kullanarak, kelime işlem belgeleri, elektronik tablolar, sunumlar, resimler, e-posta mesajları, Visio çizimleri, bazı AutoCAD ve DICOM gibi dijital görüntüleme formatlarından açıklamalar ekleyebilir, kaldırabilir ve bunlardan açıklama çıkarabilirsiniz. Ayrıca API, PDF dosyalarına açıklama eklenmesine izin verir. Açıklama için desteklenen belge biçimleri ile ilgili uzun liste hakkında bilgi edinmek için belgelere göz atabilirsiniz.
İndirin ve Yapılandırın
Açıklama kitaplığını edinin İndirmelerden veya yalnızca aşağıdaki pom.xml yapılandırmasını Maven tabanlı Java uygulamalarınıza ekleyerek bu makalenin örneklerini ve GitHub‘da bulunan daha birçok örneği deneyin. Ayrıntılar için API Referansı’nı ziyaret edebilirsiniz.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>20.2</version>
</dependency>
Java’da PDF’ye Ek Açıklamalar Ekleyin
PDF belgesine farklı türde ek açıklamalardan bazılarını eklemek için hızlı bir şekilde atlayalım. Birçok farklı ek açıklama türü olduğundan, bu makalede hepsini ele almayabiliriz. Ben sadece onlardan bahsedeceğim ve siz de her ek açıklama hakkında ayrı ayrı bilgi edinebilirsiniz.
-
Alan / Dikdörtgen notu
-
Ok
-
Mesafe
-
Elips
-
Vurgulamak
-
Bağlantı
-
Puan
-
çoklu çizgi
-
Yenisiyle değiştirme
-
Kaynak Düzeltme
-
Üstü çizili
-
Metin alanı
-
Metin Düzeltme
-
Altını çizmek
-
Filigran
Bunlardan bazılarını bir PDF belgesine eklemeye başlayalım.
Java kullanarak PDF’ye Ok Açıklama Ekleme
Aşağıdakiler, bir PDF belgesine ok notu ekleme adımlarıdır.
- Annotator sınıfını kullanarak PDF belgesini yükleyin.
- ArrowAnnotation sınıfını kullanarak ok açıklamasını başlatın.
- ArrowAnnotation’ın setBox yöntemini kullanarak okun konumunu ve boyutunu ayarlayın.
- Oluşturulan ok açıklamasını Annotator nesnesine ekleyin.
- kaydet yöntemini kullanarak yolu sağlayarak açıklamalı PDF’yi kaydedin.
Aşağıdaki kod örneği, Java kullanılarak bir PDF belgesine ok notunun nasıl ekleneceğini gösterir.
// Java kullanarak PDF'ye Ok açıklaması ekleyin
final Annotator annotator = new Annotator("document.pdf");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100)); // (x, y, width, height)
annotator.add(arrow);
annotator.save("path/annotated-with-arrow.pdf");
Java kullanarak PDF’ye Dikdörtgen veya Alan Açıklama Ekleme
Herhangi bir açıklamayı belgeye eklerken özelleştirebilirsiniz. Aşağıda, biraz daha fazla özelleştirmeyle bir PDF belgesine dikdörtgen veya alan notu ekleme adımları yer almaktadır. Arrow ek açıklaması eklemeye benzer, ancak ArrowAnnotation yerine AreaAnnotation sınıfını kullanır.
- Annotator sınıfını kullanarak PDF belgesini yükleyin.
- AreaAnnotation sınıfını kullanarak dikdörtgen ek açıklamasını başlatın.
- AreaAnnotation’ın setBox yöntemini kullanarak dikdörtgenin konumunu ve boyutunu ayarlayın.
- Renk, arka plan, opaklık, stil, kalem genişliği ve hatta mesajlar ve zaman gibi diğer özellikleri ayarlayın.
- Oluşturulan dikdörtgen ek açıklamasını Annotator nesnesine ekleyin.
- kaydet yöntemini kullanarak yolu sağlayarak açıklamalı PDF’yi kaydedin.
Aşağıdaki kod örneği, Java kullanarak bir PDF belgesine dikdörtgen/alan notunun nasıl ekleneceğini gösterir.
// Java kullanarak PDF'ye Alan Açıklama veya Dikdörtgen Açıklama Ekleyin
final Annotator annotator = new Annotator("document.pdf");
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
// belgeye ekle
annotator.add(area);
annotator.save("path/annotated-with-rectangle.pdf");
Java kullanarak PDF’ye Oval veya Elips Açıklama Ekleme
Aşağıda, bir PDF belgesine oval açıklama veya elips açıklama ekleme adımları yer almaktadır.
- Annotator sınıfını kullanarak PDF belgesini yükleyin.
- EllipseAnnotation sınıfını kullanarak elips ek açıklamasını başlatın.
- EllipseAnnotation’ın setBox yöntemini kullanarak elipsin konumunu ve boyutunu ayarlayın.
- Oluşturulan elips açıklamasını Annotator nesnesine ekleyin.
- kaydet yöntemini kullanarak yolu sağlayarak açıklamalı PDF’yi kaydedin.
Aşağıdaki kod örneği, Java kullanılarak bir PDF belgesine nasıl oval veya elips açıklama ekleneceğini gösterir.
// Java kullanarak PDF'de Oval veya Elips Açıklama Ekleme
final Annotator annotator = new Annotator("document.pdf");
// Oval veya Elips Açıklama
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
// belgeye ekle
annotator.add(area);
annotator.save("path/annotated-with-ellipse.pdf");
Java kullanarak PDF’ye Mesafe Notu Ekleme
İki nokta arasındaki mesafeyi göstermek için mesafe notunu da ekleyebilirsiniz. Aşağıda, PDF belgesine mesafe notu ekleme adımları verilmiştir.
- Annotator sınıfını kullanarak PDF belgesini yükleyin.
- DistanceAnnotation sınıfını kullanarak mesafe ek açıklamasını başlatın.
- DistanceAnnotation’ın setBox yöntemini kullanarak açıklamanın boyutunu ve konumunu ayarlayın.
- Oluşturulan mesafe açıklamasını Annotator nesnesine ekleyin.
- kaydet yöntemini kullanarak yolu sağlayarak açıklamalı PDF’yi kaydedin.
Aşağıdaki kod örneği, Java kullanarak bir PDF belgesine mesafe notunun nasıl ekleneceğini gösterir.
// Java kullanarak Mesafe Açıklama
final Annotator annotator = new Annotator("document.pdf");
// Mesafe Notu
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
// belgeye ekle
annotator.add(area);
annotator.save("path/annotated-with-distance.pdf");
Tam Kod
Özetlemek gerekirse, tüm eklenen açıklamaları ve belirtilen Java kodunu kullanarak yanıtları içeren mesajları gösteren çıktıya sahip Java kodu.
Aşağıdaki kod, bir PDF dosyasına ok, dikdörtgen, elips, mesafe ek açıklamaları, mesajlar ve yanıtlar ekler.
// Java kullanarak PDF'ye birden fazla ek açıklama ekleyin
// Java kullanarak mesaj ve yanıtlarla PDF'ye Ok, Alan, Oval (Elips), Mesafe açıklamaları ekleme
final Annotator annotator = new Annotator(Constants.INPUT);
// Ayar Yanıtları
Reply reply1 = new Reply();
reply1.setComment("Please look in to these issues.");
reply1.setRepliedOn(Calendar.getInstance().getTime());
Reply reply2 = new Reply();
reply2.setComment("Change Description");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply3 = new Reply();
reply2.setComment("On-Premises APIs");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply4 = new Reply();
reply2.setComment("Add images as well.");
reply2.setRepliedOn(Calendar.getInstance().getTime());
java.util.List<Reply> replies = new ArrayList<Reply>();
replies.add(reply1);
replies.add(reply2);
replies.add(reply3);
replies.add(reply4);
// Ok Açıklama =================================
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(560, 250, 60, -60));
arrow.setCreatedOn(Calendar.getInstance().getTime());
arrow.setMessage("This image is little upwards.");
arrow.setOpacity(0.7);
arrow.setPenColor(-3407872);
arrow.setPenWidth((byte) 2);
arrow.setReplies(replies.subList(0, 1));
// Alan Açıklama ===================================
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
area.setReplies(replies.subList(1, 2));
// Oval veya Elips Açıklama ========================
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("Shows all the available Annotation APIs.");
ellipse.setOpacity(0.7);
ellipse.setPenColor(-16034924);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies.subList(2, 3));
// Mesafe Açıklama ===============================
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is the heading area");
distance.setOpacity(0.7);
distance.setPenColor(-21197);
distance.setPenStyle(PenStyle.Solid);
distance.setPenWidth((byte) 1);
distance.setReplies(replies.subList(3, 4));
// Açıklama Ekleme =================================
annotator.add(arrow);
annotator.add(area);
annotator.add(ellipse);
annotator.add(distance);
// Açıklamalı PDF kaydediliyor ===============================
annotator.save(outputPath);
annotator.dispose();
Java’da Ek Açıklamaları PDF’den Kaldırma
Aşağıdaki adımlar, Java’daki PDF dosyalarından tüm ek açıklamaların nasıl kaldırılacağını gösterir.
- Annotator sınıfını kullanarak PDF belgesini yükleyin.
- SaveOptions sınıfını kullanarak kaydetme Seçeneklerini başlatın.
- Ek açıklama türlerini Yok olarak ayarlayın.
- kaydet yöntemini kullanarak yolu sağlayarak, tüm açıklamaları kaldırılmış PDF dosyasını kaydedin.
Aşağıdaki Java kodu, ek açıklamaları bir PDF dosyasından kaldırır.
// Java kullanarak PDF belgesindeki tüm ek açıklamaları kaldırın
final Annotator annotator = new Annotator("document.pdf");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
// PDF'yi içinde daha fazla ek açıklama olmadan kaydedin.
annotator.save("path/annotations-removed.pdf", saveOptions);
annotator.dispose();
Çözüm
Kısacası, Java uygulamalarında PDF’ye açıklama eklemeyi öğrendiniz. Ayrıca, tüm notları herhangi bir PDF dosyasından nasıl kaldıracağınızı gördünüz. Şimdi, kendi belge açıklayıcı Java uygulamanızı oluşturacağınızdan emin olmalısınız. GroupDocs.Annotation for Java’yı kullanarak farklı ek açıklama türlerini destekleyebilir.
Daha fazla ayrıntı, seçenek ve örnek için dokümantasyon ve GitHub deposunu ziyaret edebilirsiniz. Daha fazla soru için forum üzerinden destek ekibiyle iletişime geçin.