Kopf und Fußzeile zu PDF hinzufügen

Eine Kopfzeile ist ein Text, der im Randbereich oben auf einer Seite platziert wird, während eine Fußzeile am unteren Ende einer Seite platziert wird. Normalerweise werden diese Bereiche zum Einfügen von Dokumentinformationen verwendet, wie z. B. dem Namen des Dokuments, der Kapitelüberschrift, Seitenzahlen, dem Erstellungsdatum usw. Diese Informationen werden auf jeder Seite wiederholt und ermöglichen dem Leser so eine einfache Navigation im Dokument.

Beachten Sie außerdem, dass Kopf und Fußzeilen nützlich sind, um schnell Informationen über Ihr Dokument in einem vorhersehbaren Format bereitzustellen und auch dabei zu helfen, verschiedene Teile eines Dokuments zu gliedern. In diesem Artikel erfahren Sie, wie Sie mit Aspose.PDF Cloud SDK für Java Text und Bilder zu den Kopf und Fußzeilenbereichen von PDF Dateien hinzufügen.

Mit cURL Text zur Kopfzeile hinzufügen

cURL-Befehle sind eine spannende Möglichkeit, über das Befehlszeilenterminal auf RESTFul-APIs zuzugreifen. Da das Aspose.PDF Cloud SDK nach REST-Prinzipien entwickelt wurde, kann es problemlos über die Eingabeaufforderung aufgerufen werden. Beachten Sie jedoch, dass alle unsere APIs zum Schutz der Privatsphäre der Benutzer und der Datenintegrität nur autorisierten Personen zugänglich sind. Daher müssen Sie zuerst das Aspose.Cloud-Dashboard besuchen und sich einfach anmelden, wenn Sie ein GitHub oder Google-Konto haben. Andernfalls klicken Sie 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.

Der folgende Befehl zeigt, wie ein JWT-Zugriffstoken erstellt wird, der zum Hinzufügen von Text im Kopfbereich des PDF Dokuments verwendet wird.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Verwenden Sie den folgenden cURL-Befehl, um Text im Kopfbereich des PDF Dokuments hinzuzufügen.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/text?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"CENTER\",  \"Opacity\": 0.8,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 0,  \"YIndent\": 0,  \"Zoom\": 1,  \"TextAlignment\": \"CENTER\",  \"Value\": \"Aspose.PDF Cloud SDK for Java via cURL\",  \"TextState\": {    \"FontSize\": 16,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 0xDA,      \"G\": 0xA5,      \"B\": 0x20    },    \"BackgroundColor\": {      \"A\": 0,      \"R\": 0xFA,      \"G\": 0xEB,      \"B\": 0xD7    },  },  \"LeftMargin\": 1,  \"TopMargin\": 20,  \"RightMargin\": 200}"
Textkopfzeile im PDF

Bild 1: – Textüberschrift per cURL-Befehl hinzugefügt.

Die in diesem Beispiel verwendeten Beispieldateien können hier heruntergeladen werden:

Hinzufügen von Textkopfzeilen in PDF mit Java

Um das SDK verwenden zu können, müssen Sie es zunächst entweder von Maven oder GitHub installieren. Nachfolgend finden Sie Einzelheiten zum Herunterladen und Verwenden von Aspose.Pdf.jar im Maven-Build-Projekt.

Fügen Sie Ihrer pom.xml-Datei die folgenden Abhängigkeiten hinzu.

<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>

Nachfolgend finden Sie die Schritte zum Erfüllen dieser Anforderung.

  • Erstellen Sie zunächst eine Instanz von PdfApi und geben Sie die Details ClientSecret und ClientId an
  • Erstellen Sie zweitens ein Color Objekt, um die Farbdetails für Vordergrund und Hintergrund zu definieren.
  • Zweitens, erstellen Sie ein Objekt der Klasse TextState.
  • Verwenden Sie die Methode fontSize(..), um die Schriftgröße festzulegen. Die Methode font(..) definiert die Schriftart. Die Methode foregroundColor(…) definiert die Vordergrunddetails des Textes und die Methode backgroundColor(…), um die Hintergrundinformationen zu definieren.
  • Erstellen Sie nun das Objekt TextHeader und definieren Sie die Randdetails.
  • Verwenden Sie value(..)-Methoden, um den Inhalt des Textheaderobjekts anzugeben.
  • Rufen Sie nun die Methode textState(…) auf und übergeben Sie die oben erstellte Instanz von TextState als Argument.
  • Um den Header hinter dem Seiteninhalt anzuzeigen, übergeben Sie den True-Wert als Argument an die Methode background(…) der Klasse TextHeader.
  • Um nun das Bild auf der linken Seite zu rendern, übergeben Sie den Wert HorizontalAlignment.CENTER an die Methode horizontalAlignment(…).
  • Die Methode opacity(…) gibt die Deckkraft des Stempels an. Der Standardwert ist 1,0.
  • Nachdem wir den Zoomwert eingestellt haben, erstellen wir das Objekt AsposeResponse.
  • Rufen Sie abschließend die Methode PdfApi.postDocumentTextHeader(…) auf und übergeben Sie den Namen der PDF-Quelldatei, das TextHeader Objekt sowie Start und Endseiten (wo der Stempel hinzugefügt werden muss) als Argumente.
// 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 = "PdfWithAnnotations.pdf";

// Startseite des PDFs zum Platzieren des Header bilds
int startPage = 2;

// Endseite des PDFs zum Platzieren des Header bilds
int endPage = 3;
		        
// Geben Sie die Vordergrundfarbe als SlateBlue im Hex-Code an
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// Geben Sie die Hintergrundfarbe im Hex-Code als AntiqueWhite an
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// Erstellen Sie ein TextState Objekt, um Schriftgröße, Schriftart und Farbdetails zu definieren
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// Erstellen Sie eine Instanz des TextHeader Objekts
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // der Inhalt des Textheaders, der gerendert werden soll
  .value("Aspose.PDF Cloud SDK For Java")
	
  // Ausrichtung als Mitte festlegen
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // Header-Text hinter den Seiteninhalt setzen
  headerObject.background(true)
	
  // Textkopfzeilenausrichtung auf Zentriert setzen
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // Stellen Sie die Deckkraft der Textüberschrift auf 0,8 ein
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// API-Methode aufrufen, um Textkopfzeile zu PDF hinzuzufügen
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());
Textheader in Java hinzugefügt

Bild 2: Vorschau der mit Java hinzugefügten Textüberschrift.

Um Text im Fußzeilenbereich hinzuzufügen, erstellen Sie bitte eine Instanz der Klasse TextFooter und rufen Sie die Methode postDocumentTextFooter(…) der Klasse PdfApi auf. Die restlichen Schritte und Details bleiben dieselben wie oben für das Hinzufügen der Textüberschrift beschrieben.

Bild im PDF-Header mithilfe von cURL

Wir können Bilddateien ganz einfach mit der PostDocumentImageHeader-API in den Header-Bereich der PDF-Datei einfügen, indem wir den Befehl cURL verwenden. Beim Hinzufügen eines Bildstempels haben wir die Möglichkeit, Horizontale Ausrichtung, Deckkraft, Drehwinkel, Zoomfaktor des Bilds, Breite, Höhe, Linker Rand, Oberer Rand, Rechter Rand usw. anzugeben.

Der Parameter Name definiert das Eingabe-/Quell-PDF Dokument, imageHeader gibt die zu stempelnde Bilddatei an, die Eigenschaft startPageNumber definiert die Startseite und die Endseite endPageNumber die Endseite des PDF Dokuments, die Bildstempel enthalten soll. Im folgenden cURL-Befehl wird die Eigenschaft Background auf false gesetzt, damit das Bild sichtbar ist. Die HorizontalAlignment wird als Left angegeben, der Opacity-Wert wird als 0,8 definiert, der Zoomfaktor wird als 1 festgelegt, die Breite wird als 250 definiert, die Höhe wird als 80 Punkte definiert und RightMargin wird als 500 Punkte angegeben.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/image?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"  \
-H  "Content-Type: application/json" \
-d "{"Background":false,"HorizontalAlignment":'Left',"Opacity": .8,"Rotate":'None',"RotateAngle": 0,"XIndent": 2,"YIndent": 5,"Zoom": 1,"FileName": 'asposetoolsnew.png',"Width": 250,"Height": 80,"LeftMargin": 1,"TopMargin": 10,"RightMargin": 500}"
Bildstempel im Header

Bild 3: – Bildstempel im Kopfbereich des PDF.

Die im obigen Beispiel verwendeten Beispieldateien können unter folgendem Link heruntergeladen werden:

Mit Java ein Bild in die Kopfzeile einfügen

Aspose.PDF Cloud SDK für Java bietet eine bemerkenswerte Funktion, um einer PDF-Datei mit weniger Codezeilen einen Bildheader hinzuzufügen.

Nachfolgend finden Sie Schritte zum Hinzufügen von Bildkopfzeilen in PDF Dokumenten

  • Erstellen Sie ein Objekt von PdfApi und geben Sie die Details ClientSecret und ClientId an.
  • Zweitens erstellen Sie ein Objekt der Klasse ImageHeader.
  • Verwenden Sie die Methoden width(..) und height(…) der ImageHeader Klasse, um Details zur Bildbreite und -höhe festzulegen.
  • Verwenden Sie nun die Methode fileName(…), um die Pfaddetails für das Kopfzeilenbild festzulegen.
  • Um das Bild hinter dem Seiteninhalt anzuzeigen, übergeben Sie das Argument „false“ an die Methode „background(…)“.
  • Um nun das Bild auf der linken Seite zu rendern, übergeben Sie den Wert HorizontalAlignment.LEFT an die Methode horizontalAlignment(…).
  • Die Methode opacity(…) gibt die Deckkraft des Stempels an. Der Standardwert ist 1,0.
  • Nachdem wir den Zoomwert eingestellt haben, erstellen wir das Objekt AsposeResponse.
  • Rufen Sie abschließend die Methode PdfApi.postDocumentImageHeader(…) auf und übergeben Sie dieser Methode den Namen der PDF-Quelldatei, das ImageHeader Objekt sowie die Start und Endseiten (auf denen der Stempel hinzugefügt werden muss) als Argumente.
// 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 = "PdfWithAnnotations.pdf";

// Startseite des PDFs zum Platzieren des Header bilds
int startPage = 2;

// Endseite des PDFs zum Platzieren des Header bilds
int endPage = 3;
		        
// Erstellen Sie eine Instanz des ImageHeader Objekts
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// Headerbild in den Vordergrund/sichtbar bringen
	headerObject.background(false)
	
	// Stellen Sie die Ausrichtung der Bildkopfzeile auf „Links“ ein.
	.horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.LEFT)
	.opacity(0.8)
	.rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
	.rotateAngle(0.)
	.xindent(2.0)
	.yindent(5.0)
	.zoom(1.0);

// API-Methode aufrufen, um Header bild in PDF einzufügen
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

Um ein Bild im Fußzeilenbereich einzufügen, erstellen Sie ein Objekt der Klasse ImageFooter und rufen Sie die Methode postDocumentImageFooter(…) der Klasse pdfApi auf. Die restlichen Schritte bleiben dieselben wie oben für das Bild im Abschnitt „Kopfzeile“ erläutert.

Abschluss

In diesem Artikel haben wir die Schritte erläutert, wie Sie über cURL-Befehle auf Aspose.PDF Cloud zugreifen können, um Text und Bilder in Kopf-/Fußzeilenbereiche von PDF Dokumenten einzufügen. Wir haben auch die Schritte zur Installation von Aspose.PDF Cloud SDK für Java und zur Verwendung in der Java-Sprache zum Hinzufügen von Text und Bildern in den Kopf oder Fußzeilenbereich der PDF-Datei untersucht. Weitere Einzelheiten zu anderen spannenden Funktionen der API finden Sie in der Produktdokumentation.

Alle unsere Cloud SDKs sind OpenSource, daher kann ein vollständiger Quellcode von GitHub heruntergeladen werden.