A quick view of MS Word document transformation.
Et sidehoved er den øverste margen på hver side, og en sidefod er den nederste margen på hver side. Sidehoveder og sidefødder er nyttige til at inkludere oplysninger, som du vil have vist på hver side i et dokument, såsom dit navn, datoer, titlen på dokumentet, sidetal eller ansvarsfraskrivelser til dokumenter. Når du bruger MS Word, giver det mulighed for at tilføje sidehoveder og sidefødder baseret på foruddefinerede layouts eller give dig mulighed for at tilføje brugerdefinerede sidehoveder og sidefødder. De fleste indbyggede overskrifter indeholder pladsholdertekst, og enten kan du beholde pladsholderteksten eller erstatte den med dit eget datafeed. Når du opdaterer oplysningerne i sektionen Sidehoved eller Sidefod, er indholdet i dokumentets hoveddel nedtonet, hvilket indikerer, at disse objekter er fuldstændig isoleret fra resten af sideindholdet, og den handling, du udfører på disse objekter, er specifik for disse områder. I denne artikel skal vi lære trinene til, hvordan du tilføjer eller opdaterer sidehovedets sidefod i Word-dokument ved hjælp af REST API.
Tekstbehandlings-API
Aspose.Words Cloud API giver mulighed for at indlæse MS Word filer fra Cloud-lager, ligesom det giver brugeren mulighed for at videregive inputfilen direkte i anmodningsteksten, og API’en returnerer den opdaterede fil i svarobjektet. Det giver funktionerne til at læse, tilføje, opdatere eller slette specifikke eller alle sidehoved- og sidefodobjekter. Desuden kan du også specificere at gengive forskellige sidehoveder/sidefødder for den første side og for ulige/lige sider.
Derudover giver API’en dig også mulighed for at indstille formateringsoplysninger såsom skrifttype- og afsnitsegenskaber for sidehoved-/sidefodteksten. Du får også mulighed for at indsætte dynamiske sidetal i sidehoved/sidefodsektionen. Sidst, men ikke mindst, kan du overveje at bruge tabelobjekter til at få den ene del af sidehoved/sidefod til at blive tekstjusteret til venstre kant og den anden til højre kant.
Artiklens omfang
Vores Aspose.Words Cloud SDK til .NET giver dig mulighed for at arbejde med Aspose.Words Cloud REST API’er hurtigt og nemt, da det tager sig af en masse detaljer på lavt niveau med hensyn til at lave anmodninger og håndtere svar og lader dig fokusere på at skrive kode, der er specifik til dine forretningskrav. I denne artikel skal vi bruge Aspose.Words Cloud SDK til .NET i Visual Studio til Mac. Dette indlæg definerer trinene til at indsætte sidehovedfod i Word-dokument, hvor tilpasset formatering vil blive defineret. Derefter opdateres formateringen af afsluttende sidefodsindhold, og sidenummeroplysningerne indsættes nederst til højre. Alle disse operationer vil blive udført i skyen.
Installation
For at komme i gang skal du først installere Visual Studio på dit system. Opret en prøveløsning, og tilføj NuGet-reference for Aspose.Words Cloud SDK for .NET. Så for at tilføje en reference skal du højreklikke på løsningen og vælge Administrer NuGet-pakker… menuvalg. Indtast Aspose.Words-Cloud i søgetekstfeltet. Vælg indstillingen, og klik på knappen Tilføj pakke.
Nu dukker Aspose.Words.Cloud.Sdk reference op i løsningen. Der er nogle fordele ved at bruge cloud API’er i modsætning til on-premise (aspose.com) API’er. Årsagen er, at du ikke manuelt behøver at holde styr på og opdatere API-versionerne, og du behøver ikke betale for hele licensen.
Aspose.Cloud Dashboard
Du skal blot oprette en konto på Aspose.Cloud dashboard eller tilmelde dig via din eksisterende Google- eller GitHub-konto og begynde at bruge vores Cloud API’er. En anden fantastisk funktion ved Cloud API’er er, at du kan bruge dem på enhver platform ved hjælp af et hvilket som helst understøttet sprog.
Som angivet ovenfor lægger artiklen vægt på muligheder for tilføjelse og opdatering af sidehoved- og sidefodsobjekter i MS Word-dokumenter. Af hensyn til testen har vi brugt en eksisterende MS Word dokumentskabelon med navnet Business Letter. Dokumentet skal uploades til Aspose cloud storage, og al manipulation og dokumentbehandling vil blive udført over skyen. Når al behandling er afsluttet, kan vi også downloade den resulterende filkopi fra skylageret.
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
For nu at bruge Aspose.Cloud API’er skal du bruge App Key og App SID information i din kode. Disse taster består af alfanumeriske cifre. Disse er unikke koder knyttet til din abonnementskonto. For at få disse detaljer skal du klikke på fanen Mine apps på Aspose.Cloud-dashboard. Når vi har nøglerne, skal vi initialisere Aspose.Words API-objektet.
string MyAppKey = "f6axxxxxxxxxxxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
Indsæt overskriftsobjekt
For at tilføje header-objektet i MS Word-filen skal vi udføre følgende operationer i rækkefølge.
- Opret et objekt af InsertHeaderFooterRequest, hvor vi sender HeaderFooterLink-typen som et argument.
- Indsæt HeaderFooterRequest-objekt til WordsApi-objekt ved hjælp af metoden InsertHeaderFooter (…).
- Opret et Kør-objekt, som indeholder eksempeltekstinformation.
- Opret InsertRunRequest-objekt, hvor vi sender referencen til paragraph(SectionPath) i HeaderFooter-objekt, hvor Run-tekst skal tilføjes.
Kald derefter InsertRun (…) metoden i WordsApi, som tilføjer RunRequest til HeaderFooter-objektet.
HeaderFooter.TypeEnum kan være en af følgende værdier.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// oprette et objekt af WordsAPI, mens du sender AppKey- og AppSid-oplysninger
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// upload eksempeldokument til cloud storage
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Indsæt overskriftsobjekt på første side
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Opret Kør-objekt, der indeholder eksempeltekst
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// tilføj Kør-teksten til første afsnit af det første HeaderFooter-objekt i første sektion af Word-dokument
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// Indsæt RunRequest til Word-dokument
var actual2 = wordsApi.InsertRun(runRequest);
Image showing preview of recently added Header
Opdater tekstformatering af Nyligt indsat overskrift
Når Header-objektet er tilføjet, kan vi opdatere tekstformateringen af indholdet i det. For at opfylde dette krav skal vi udføre følgende trin.
- Opret et objekt af skrifttypeklassen, hvor vi angiver skrifttypenavn, størrelse, farveoplysninger.
- For at gøre teksten mere præsentabel skal du markere Engrave property som True.
- Opret et objekt af klassen UpdateRunFontRequest, hvor vi sender inputfilen, Font, SectionPath og runIndex som et argument.
- Til sidst skal du bruge metoden UpdateRunFont(..) og tilføje UpdateRunFontRequest-objektet til WordsApi-forekomsten.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// oprette et objekt af WordsAPI, mens du sender AppKey- og AppSid-oplysninger
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// upload eksempeldokument til cloud storage
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Det næste trin er at indstille formateringen af Header Object
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
// Indstil formatering af tekst som gravering
fontDto.Engrave = true;
// Anvend formatering på første afsnit af HeaderFooter-objekt
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);
Image showing preview of Header after text formatting has been applied.
Opdater formatering af eksisterende footer-objekt
API’en tilbyder også funktionen til at opdatere formateringen af indhold inde i det eksisterende Header/Footer-objekt. For at opfylde dette krav kan vi bruge de ovenfor angivne kodelinjer, men den eneste forskel er ændringen af sidefodsindeks til 2. Se følgende kodelinje.
// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);
Image displaying the change in Footer text formatting.
Tilføj sidenummeroplysninger i sidefodsektionen
Sidetal giver meget nyttige oplysninger såsom den aktuelle side og det samlede antal sider i et dokument. De følgende trin definerer, hvordan kravene skal opfyldes.
- Opret først et objekt af klassen PageNumber, hvor vi definerer, Justering af tekst, formatet af teksten, placering for at rendere PageNumber-information og også angive, om SideNumber skal gengives på den første side eller ej.
- Opret InsertPageNumbersRequest-objekt og send PageNumber-objekt som et argument.
- Til sidst skal du kalde InsertPageNumbers(..)-metoden for at tilføje InsertPageNumbersRequest til WordsApi-forekomsten.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// oprette et objekt af WordsAPI, mens du sender AppKey- og AppSid-oplysninger
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// upload eksempeldokument til cloud storage
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// API'en tilbyder også funktionen til at tilføje sidenummerdetaljer i HeaderFooter-objekt
// Tilføj sidenummeroplysninger til højre nederst på siden
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// Indsæt sidenummeroplysninger i Word-dokument
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
Preview Page number in the footer section.
Konklusion
I denne artikel har vi lært trinene til, hvordan du tilføjer en sidehovedsidefod i Word-dokument ved hjælp af Aspose.Words Cloud SDK til .NET. Bemærk venligst, at vi også har Cloud SDK’er tilgængelige for Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android. For yderligere detaljer, besøg venligst Aspose.Words Cloud.
Relaterede artikler
Vi anbefaler også at besøge følgende for at lære mere om