Markieren oder streichen Sie Text und fügen Sie mithilfe der Java REST API Linien oder Kreisanmerkungen in PDF Dateien hinzu.

Der Inhalt einer PDF-Seite lässt sich nur schwer bearbeiten. Die PDF-Spezifikation definiert jedoch einen vollständigen Satz von Objekten, die zu PDF-Seiten hinzugefügt werden können, ohne den Seiteninhalt zu ändern. Diese Objekte werden Annotationen genannt und ihr Zweck reicht von der Markierung von Seiteninhalten bis zur Implementierung interaktiver Funktionen wie Formularen.

Die meisten PDF-Viewer ermöglichen das Erstellen und Bearbeiten verschiedener Anmerkungstypen, z. B. Texthervorhebungen, Notizen, Linien oder Formen. Unabhängig von den erstellten Anmerkungstypen sollten PDF-Viewer, die der PDF-Spezifikation entsprechen, auch das Rendern aller Anmerkungstypen unterstützen. Bei der Verarbeitung einer großen Anzahl von Dokumenten wird das manuelle Hinzufügen von Anmerkungen jedoch mühsam, sodass eine Programmier-API eine praktikable Lösung darstellt. Wir werden außerdem die Verwendung von Aspose.PDF Cloud SDK für Java zum Hinzufügen von Anmerkungen zu PDF Dokumenten besprechen.

Installation des SDK
Text mit Java durchstreichen
Hervorhebungsanmerkung hinzufügen
So fügen Sie Zeilenanmerkungen hinzu
Kreisanmerkungen in PDF hinzufügen

Installation des SDK

Aspose.PDF Cloud SDK für Java ist eine Programmier-API, die es Java-Programmierern ermöglicht, PDF Dokumente zu erstellen, zu bearbeiten und in andere unterstützte Dokumentformate umzuwandeln. Das Cloud SDK steht über Maven und GitHub zum Download bereit. Fügen Sie nun die folgenden Details in Ihre pom.xml-Datei ein, um Aspose.Pdf.jar herunterzuladen und in Ihrem Maven-Build-Projekt zu verwenden.

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

Weitere Informationen finden Sie unter So installieren Sie Aspose.Cloud SDKs.

Beachten Sie außerdem, dass alle unsere APIs zum Schutz der Privatsphäre und Datenintegrität der Benutzer nur autorisierten Personen zugänglich sind. Besuchen Sie daher zunächst das Aspose.Cloud-Dashboard und registrieren Sie sich, wenn Sie ein GitHub oder Google-Konto haben. Klicken Sie andernfalls auf die Schaltfläche Neues Konto erstellen und geben Sie die erforderlichen Informationen ein. Melden Sie sich nun mit Ihren Anmeldeinformationen beim Dashboard an, erweitern Sie den Abschnitt „Anwendungen“ im Dashboard und scrollen Sie nach unten zum Abschnitt „Client-Anmeldeinformationen“, um die Details zu Client-ID und Client-Geheimnis anzuzeigen.

Text mit Java durchstreichen

Manchmal müssen wir bestimmte Inhalte im Dokument als veraltet markieren, ohne sie aus dem Dokument zu entfernen. Das Durchgestrichene (auch als Strikeout bezeichnet) wird durch Wörter mit einem horizontalen Strich durch die Mitte dargestellt. Es bedeutet, dass der Text falsch oder veraltet ist und kürzlich gelöscht oder als solcher markiert wurde. Wir können die Einstellungen der Durchgestrichen-Anmerkungen mit der Eigenschaft strikethroughSettings festlegen. Die Eigenschaft strikethroughSettings wird verwendet, um die Eigenschaften Farbe, Deckkraft, Autor, Betreff, geändertes Datum und isLocked der Durchgestrichen-Anmerkungen festzulegen.

// Holen Sie sich ClientID und ClientSecret von https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi-Instanz
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF Dokument eingeben
String sourcePDF = "PdfWithTable.pdf";	        
			        
int pageNumber = 1;
// rechteckigen Bereich für Annotation erstellen  
Rectangle rect = new Rectangle()
    .LLX(200.)
    .LLY(380.)
    .URX(250.)
    .URY(375.);

List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

List<Point> points = new ArrayList<>();
points.add(new Point().X(132.).Y(380.)); // Top-Left edge of the Strike Through line
points.add(new Point().X(95.).Y(10.));	// Top-Right edge of the strike through line
points.add(new Point().X(130.).Y(25.));
points.add(new Point().X(130.).Y(10.));

StrikeOutAnnotation annotation = new StrikeOutAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setZindex(1);
annotation.setTitle("Title");
annotation.setQuadPoints(points);
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        

List<StrikeOutAnnotation> annotations = new ArrayList<>();
annotations.add(annotation);

AsposeResponse response = pdfApi.postPageStrikeOutAnnotations(sourcePDF, pageNumber, annotations, null, null);
assertEquals(200, (int)response.getCode());

Hervorhebungsanmerkung hinzufügen

Das Hervorheben des Inhalts in PDF Dokumenten ist wichtig, da wir dadurch die Aufmerksamkeit auf wichtige Informationen im Dokument lenken können. Hervorheben ist effektiv, da der Leser dadurch zunächst aufgefordert wird, die wichtigen Teile herauszusuchen, und dann eine effektive Möglichkeit erhält, diese Informationen später noch einmal zu überprüfen. Unsere Cloud-API bietet die Möglichkeit, Inhalte in PDF Dokumenten hervorzuheben. Nachfolgend finden Sie die Schritte zum Hinzufügen von Hervorhebungsanmerkungen in einer PDF-Datei.

Erstellen Sie zunächst eine Instanz von PdfApi und geben Sie die Details ClientSecret und ClientId an.
Wir erstellen eine File-Instanz, um eine PDF-Datei vom lokalen System zu laden, und rufen dann die Methode uploadFile(…) der Klasse PdfApi auf, um das Dokument in den Cloud-Speicher hochzuladen.
Erstellen Sie nun eine Instanz der Rectangle Klasse, um den rechteckigen Bereich anzugeben, in dem Anmerkungen hinzugefügt werden können.
Erstellen Sie dann eine ArrayList vom Typ „Point“, um die Informationen zu den Punkten zum Zeichnen der HighlightAnnotation aufzunehmen.
Erstellen Sie ein Objekt der Klasse HighlightAnnotation und legen Sie Name, rechteckigen Bereich, Betreff, Titel, QuadPoints und Änderungsdatum der Annotation fest.
Der nächste Schritt besteht darin, eine Liste vom Typ „HighlightAnnotation“ zu erstellen und das oben erstellte HighlightAnnotation Objekt zu dieser Liste hinzuzufügen.
Rufen Sie abschließend die Methode postPageHighlightAnnotations(…) der Klasse PdfApi auf und übergeben Sie Quell-PDF, Seitenzahl und Anmerkungsliste als Argumente.

Vorschau der Highlight-Anmerkung — Bild 1: – Anmerkung in PDF-Datei hervorheben.

Sie können die im obigen Beispiel verwendeten Beispieldateien über die folgenden Links herunterladen

So fügen Sie Zeilenanmerkungen hinzu

Ähnlich wie beim Hinzufügen von Durchstreichungs und Hervorhebungsanmerkungen können Sie mit der API auch Zeilenanmerkungen in PDF Dokumente einfügen. Wir haben eine Klasse namens LineAnnotation, um diese Anforderung zu erfüllen. Nachfolgend finden Sie weitere Einzelheiten dazu, wie diese Anforderung erfüllt werden kann.

Erstellen Sie zunächst eine Instanz von PdfApi und geben Sie die Details ClientSecret und ClientId an.
Optional erstellen wir eine File-Instanz, um eine PDF-Datei vom lokalen System zu laden, und rufen dann die Methode uploadFile(…) der Klasse PdfApi auf, um das Dokument in den Cloud-Speicher hochzuladen. Falls die Datei bereits im Cloud-Speicher verfügbar ist, können wir sie verwenden.
Die restlichen Initialisierungseigenschaften des Objekts sind dieselben wie oben für HighlithAnnotation erwähnt, außer dass wir ein Objekt der Klasse LineAnnotation erstellen und den Start und Endpunkt einer Linie mit den Methoden setStarting(…) und setEnding(…) festlegen müssen.

// Holen Sie sich ClientID und ClientSecret von https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// createPdfApi-Instanz
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF Dokument eingeben
String sourcePDF = "PdfWithTable.pdf";	        
			    
// Laden Sie die Datei vom lokalen System
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// Laden Sie die Datei in den Cloud-Speicher hoch
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);

// Seitenzahl, auf der die Anmerkung hinzugefügt wird				
int pageNumber = 1;

// rechteckigen Bereich für Annotation erstellen  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(500.)
    .URX(400.)
    .URY(510.);

// Erstellen Sie ein List Objekt vom Typ AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// Zeilenanmerkungsobjekt erstellen
LineAnnotation annotation = new LineAnnotation();

annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// Legen Sie den Startpunkt der Linie fest
annotation.setStarting(new Point().X(100.).Y(100.));
// Endpunkt der Linie festlegen
annotation.setEnding(new Point().X(20.).Y(680.));

// Farbinstanz für Staleblue erstellen
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// Anmerkungsfarbe festlegen
annotation.interiorColor(color);

// Annotation-Änderungsdatum festlegen			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// Listeninstanz von Zeilenanmerkungen erstellen
List<LineAnnotation> annotations = new ArrayList<>();
// LineAnnotation Objekt zur Liste der Zeilenanmerkungen hinzufügen
annotations.add(annotation);

// API-Methode aufrufen, um Zeilenanmerkungen zur PDF-Datei hinzuzufügen
AsposeResponse response = pdfApi.postPageLineAnnotations(sourcePDF, pageNumber, annotations, null, null);

Kreisanmerkungen in PDF hinzufügen

Kreisanmerkungen werden auch häufig in PDF Dokumenten verwendet und die API unterstützt diesen Anmerkungstyp sehr gut. Um Kreisanmerkungen hinzuzufügen, verwenden Sie bitte die Klasse CircleAnnotation. Der unten angegebene Code kann verwendet werden, um diese Anforderung zu erfüllen.

// Holen Sie sich ClientID und ClientSecret von https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// createPdfApi-Instanz
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF Dokument eingeben
String sourcePDF = "PdfWithTable.pdf";	        
			    
// Laden Sie die Datei vom lokalen System
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// Laden Sie die Datei in den Cloud-Speicher hoch
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);
// Seitenzahl, auf der die Anmerkung hinzugefügt wird				
int pageNumber = 1;

// rechteckigen Bereich für Annotation erstellen  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(700.)
    .URX(300.)
    .URY(500.);

// Erstellen Sie ein List Objekt vom Typ AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// Highlight-Annotations Objekt erstellen
CircleAnnotation annotation = new CircleAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// Farbinstanz für Staleblue erstellen
Color color = new Color();
color.setR(0xC7);
color.setG(0xE2);
color.setB(0x6f);
// Anmerkungsfarbe festlegen
annotation.interiorColor(color);

// Annotation-Änderungsdatum festlegen			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// Listeninstanz von Highlight-Anmerkungen erstellen
List<CircleAnnotation> annotations = new ArrayList<>();

// CircleAnnotation Objekt zur Liste der Kreisanmerkungen hinzufügen
annotations.add(annotation);

// API-Methode aufrufen, um Kreisanmerkungen zur PDF-Datei hinzuzufügen
AsposeResponse response = pdfApi.postPageCircleAnnotations(sourcePDF, pageNumber, annotations, null, null);

Das Eingabe-PDF Dokument und das resultierende PDF, wie oben gezeigt, können von den folgenden Links heruntergeladen werden:

Kurztipp

Verwenden Sie unsere kostenlose Online-App PDF-Anmerkungs-App, um alle Anmerkungen mit einem Klick aus Ihrem PDF zu entfernen.

Abschluss

In diesem Blog haben wir verschiedene Anmerkungstypen besprochen, die derzeit von Aspose.PDF Cloud SDK für Java unterstützt werden. Abgesehen von Anmerkungen unterstützt die API eine Vielzahl weiterer spannender Funktionen im Zusammenhang mit dem PDF-Format. Für weitere Informationen empfehlen wir Ihnen, den Entwicklerleitfaden weiter zu lesen.

Bitte beachten Sie, dass wir stets bestrebt sind, den Kunden bestmöglich zu dienen und ihr Feedback und ihre Vorschläge zu schätzen wissen. Falls Sie also bei der Verwendung der API auf ein Problem stoßen oder eine entsprechende Frage haben, können Sie uns gerne über unser Kostenloses Support-Forum kontaktieren.

Installation des SDK#

Text mit Java durchstreichen#

Hervorhebungsanmerkung hinzufügen#

So fügen Sie Zeilenanmerkungen hinzu#

Kreisanmerkungen in PDF hinzufügen#

Kurztipp#

Abschluss#

Verwandte Artikel#