Et sidehoved er en tekst, der er placeret i margenområdet øverst på en side, mens en sidefod er placeret i bunden eller foden af en side. Typisk bruges disse områder til at indsætte dokumentinformation, såsom dokumentets navn, kapiteloverskrift, sidetal, oprettelsesdato osv. Denne information gentages på hver side og gør det således nemt for læseren at navigere i dokumentet.
Desuden skal du være opmærksom på, at sidehoveder og sidefødder er nyttige til at give hurtig information om dit dokument i et forudsigeligt format og også hjælpe med at angive forskellige dele af et dokument. I denne artikel skal vi lære at tilføje tekst og billeder til sidehoved- og sidefodsområderne i PDF-filer ved hjælp af Aspose.PDF Cloud SDK for Java.
- Tilføj tekst til sidehoved ved hjælp af cURL
- Tilføjelse af tekstoverskrift i PDF ved hjælp af Java
- Billede i PDF-header ved hjælp af cURL
- Tilføj billede i Header ved hjælp af Java
Tilføj tekst til sidehoved ved hjælp af cURL
cURL-kommandoer er en spændende måde at få adgang til RESTFul API’er gennem kommandolinjeterminalen. Da Aspose.PDF Cloud SDK er udviklet i henhold til REST-principperne, så det nemt kan tilgås via kommandoprompt. Bemærk dog, at for at sikre brugernes privatliv og dataintegritet, er alle vores API’er kun tilgængelige for autoriserede personer. Derfor skal du først besøge Aspose.Cloud dashboard, og hvis du har GitHub eller Google-konto, skal du blot tilmelde dig. Ellers skal du klikke på knappen Opret en ny konto og angive de nødvendige oplysninger. Log nu ind på dashboardet ved hjælp af legitimationsoplysninger og udvid applikationssektionen fra dashboardet, og rul ned mod sektionen Klientlegitimationsoplysninger for at se klient-id og klienthemmelighedsoplysninger.
Den følgende kommando viser, hvordan man opretter et JWT-adgangstoken, som skal bruges til at tilføje tekst i Header-området i PDF-dokumentet.
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"
Brug følgende cURL-kommando er at tilføje tekst i sidehovedsektionen af PDF-dokumentet.
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}"
Billede 1:- Tekstoverskrift tilføjet via cURL-kommandoen.
Eksempelfilerne brugt i dette eksempel kan downloades fra:
Tilføjelse af tekstoverskrift i PDF ved hjælp af Java
For at bruge SDK’et skal du først installere det enten fra Maven eller GitHub. Nedenstående er detaljerne om, hvordan man downloader og bruger Aspose.Pdf.jar i Maven-byggeprojektet.
Tilføj følgende afhængigheder i din pom.xml-fil.
<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>
Nedenfor er trinene til, hvordan du opfylder dette krav.
- Først og fremmest skal du oprette en forekomst af PdfApi, mens du giver ClientSecret og ClientId detaljer
- For det andet skal du oprette et Color objekt for at definere ForeGround og BackGround farvedetaljer.
- For det andet skal du oprette et objekt af klassen TextState.
- Brug metoden fontSize(..) til at angive skriftstørrelsesdetaljer. Skrifttype(..)-metoden til at definere skrifttypen. ForegroundColor(…)-metoden definerer tekstforgrundsdetaljer, og backgroundColor(…)-metoden til at definere baggrundsinformation.
- Opret nu TextHeader objekt og definer margendetaljer.
- Brug værdi(..) metoder til at angive indholdet af teksthovedobjektet.
- Kald nu textState(…)-metoden og send ovenstående oprettede TextState-instans som argument.
- For at vise overskriften bag sideindholdet skal du videregive den sande værdi som et argument til baggrundsmetoden (…) i klassen TextHeader.
- For nu at gengive billedet på venstre side, skal du overføre værdien HorizontalAlignment.CENTER til metoden horizontalAlignment(…).
- Opacitet(…)-metoden angiver stemplets opacitet. Standardværdien er 1,0.
- Når vi har indstillet zoomværdien, skal du oprette AsposeResponse objekt.
- Til sidst skal du kalde PdfApi.postDocumentTextHeader(…)-metoden og sende kilde-PDF-filnavn, TextHeader-objekt, start- og slutsider (hvor stempel skal tilføjes) som argumenter.
// Få ClientID og ClientSecret fra https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
// oprette PdfApi instans
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
// input PDF-dokument
String sourcePDF = "PdfWithAnnotations.pdf";
// startsiden af PDF for at placere Header Image
int startPage = 2;
// slutside af PDF for at placere headerbillede
int endPage = 3;
// angiv forgrundsfarven som SlateBlue i hex-kode
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);
// angiv baggrundsfarve som AntiqueWhite i hex-kode
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);
// Opret TextState-objekt for at definere skriftstørrelse, ansigt og farvedetaljer
TextState textState = new TextState()
.fontSize(16.)
.foregroundColor(foregroundColor)
.backgroundColor(backgroundColor)
.font("Arial");
// oprette en forekomst af TextHeader-objekt
TextHeader headerObject = new TextHeader()
.leftMargin(1.)
.rightMargin(200.)
.topMargin(10.)
// indholdet af tekstoverskriften, der skal gengives
.value("Aspose.PDF Cloud SDK For Java")
// sæt justering som center
.textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
.textState(textState);
// sæt overskriftstekst bag sideindhold
headerObject.background(true)
// sæt justering af teksthoved som Center
.horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
// sæt opaciteten af tekstoverskrift til 0,8
.opacity(0.8)
.rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
.rotateAngle(0.)
.xindent(2.0)
.yindent(5.0)
.zoom(1.0);
// kald API-metoden for at tilføje tekstoverskrift til PDF
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());
Billede 2:- Forhåndsvisning af tekstoverskrift tilføjet med Java.
For at tilføje tekst i sidefodsområdet skal du oprette en forekomst af klassen TextFooter og kalde postDocumentTextFooter(…) metoden af klassen PdfApi. De resterende trin og detaljer forbliver de samme som nævnt ovenfor for tilføjelse af tekstoverskriften.
Billede i PDF-header ved hjælp af cURL
Vi kan nemt tilføje billedfiler ved hjælp af PostDocumentImageHeader API i header-sektionen af PDF-filen ved hjælp af cURL-kommandoen. Mens vi tilføjer et billedstempel, får vi muligheden for at specificere Horisontal Alignment, Opacitet, RotateAngle, Zoomfaktor på billedet, Bredde, Højde, Venstremargin, Topmargin, Højremargin osv.
Navn-parameteren definerer input/kilde-PDF-dokumentet, imageHeader angiver billedfilen, der skal stemples, startPageNumber-egenskaben definerer startside og endPageNumber-slutside i PDF-dokument til at indeholde billedstempler. I den følgende cURL-kommando er egenskaben Background angivet som falsk, så billedet er synligt. Den horisontale justering er angivet som venstre, opacitetsværdien er defineret som 0,8, zoomfaktoren er angivet som 1, bredden er defineret som 250, højden er defineret som 80 punkter og højremarginen er angivet som 500 punkter.
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}"
Billede 3:- Billedstempel i sidehovedsektionen af PDF.
Eksempelfilerne brugt i ovenstående eksempel kan downloades fra følgende link:
Tilføj billede i Header ved hjælp af Java
Aspose.PDF Cloud SDK til Java giver en bemærkelsesværdig funktion til at tilføje en billedhoved i en PDF-fil med færre kodelinjer.
Nedenstående er trin til, hvordan du tilføjer billedhoved i PDF-dokument
- Opret et objekt af PdfApi, mens du giver ClientSecret og ClientId detaljer.
- For det andet skal du oprette et objekt af klassen ImageHeader.
- Brug metoderne bredde(..) og højde(…) i ImageHeader-klassen til at indstille billedbredde og højdedetaljer.
- Brug nu filnavn(…)-metoden til at angive stidetaljer for headerbilledet.
- For at vise billedet bag sideindholdet, skal du videregive det falske argument til baggrunden(…)-metoden.
- For nu at gengive billedet i venstre side, skal du overføre værdien HorizontalAlignment.LEFT til metoden horizontalAlignment(…).
- Opacitet(…)-metoden angiver stemplets opacitet. Standardværdien er 1,0.
- Når vi har indstillet zoomværdien, skal du oprette AsposeResponse objekt.
- Til sidst skal du kalde PdfApi.postDocumentImageHeader(…)-metoden, mens du sender kilde-PDF-filnavn, ImageHeader-objekt, start- og slutsider (hvor stempel skal tilføjes) som argumenter til denne metode.
// Få ClientID og ClientSecret fra https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
// oprette PdfApi instans
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
// input PDF-dokument
String sourcePDF = "PdfWithAnnotations.pdf";
// startsiden af PDF for at placere Header Image
int startPage = 2;
// slutside af PDF for at placere headerbillede
int endPage = 3;
// oprette en forekomst af ImageHeader-objekt
ImageHeader headerObject = new ImageHeader()
.width(250.0)
.height(80.0)
.leftMargin(1.)
.rightMargin(500.)
.topMargin(10.)
.fileName("asposetoolsnew.png");
// bringe Header Image til forgrunden/synligt
headerObject.background(false)
// sæt billedhovedjustering som Venstre
.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);
// kald API-metoden for at tilføje Header Image i PDF
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);
For at tilføje et billede i sidefodsområdet skal du oprette et objekt af klassen ImageFooter og kalde postDocumentImageFooter(…)-metoden for pdfApi-klassen. Resten af trinene forbliver de samme som forklaret ovenfor for billedet i sidehovedsektionen ovenfor.
Konklusion
I denne artikel har vi diskuteret trinene til, hvordan du får adgang til Aspose.PDF Cloud via cURL-kommandoer for at tilføje tekst og billeder i sidehoved-/sidefodområder i PDF-dokumenter. Vi har også undersøgt trinene til at installere Aspose.PDF Cloud SDK for Java og bruge det i Java-sprog til at tilføje tekst og billede i sidehoved- eller sidefodssektionen i PDF-filen. For flere detaljer om andre spændende funktioner i API’et, udforsk venligst produktdokumentation.
Alle vores Cloud SDK’er er OpenSource, så en komplet kildekode kan downloades fra GitHub.