Indsæt overskrifter og sidetal i et Word-dokument

Overskriften er en sektion af dokumentet, der vises i den øverste margen og generelt indeholder oplysninger såsom sidenummer, dato og dokumentnavn. Med Aspose.Words REST APIs kan du indsætte sidenummer i Word-dokument samt sidehoveder. Som standard er overskrifterne de samme på hver side, men vi kan oprette forskellige overskrifter til ulige og lige sider.

Dette indlæg har til formål at opnå følgende layout af dokumentet, hvor overskriften på den første side er forskellig fra resten af siderne:

Før vi kalder en Aspose REST API, skal vi oprette Aspose Cloud-konto og få vores appnøgle og app-SID. Kom godt i gang artiklen forklarer, hvordan du udfører disse trin.

Desuden skal vi uploade eksempeldokumentet til Cloud Storage, da alle handlinger på dokumentet vil blive udført i skyen:

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

string MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/

StorageApi storageApi = new StorageApi(MyAppKey, MyAppSid);

string fileName = "Sample-Document.docx";

// Upload kildedokument til Cloud Storage
PutCreateRequest request = new PutCreateRequest(fileName, File.OpenRead(@"c:\Data\" + fileName), null, null);
storageApi.PutCreate(request);

Indsæt overskrift i et Word-dokument

Insert Header Footer API tilføjer sidehoveder i et dokument, og dens headerFooterType-parameter kan have en af følgende seks værdier:

HeaderFirst - Header til den første side af sektionen.

HeaderPrimary - Primær sidehoved, bruges også til sider med ulige nummer.

HeaderEven - Header for lige nummererede sider.

FooterFirst - Sidefod til den første side af sektionen.

FooterPrimary - Primær sidefod, bruges også til sider med ulige nummer.

FooterEven - Sidefod til sider med lige nummer.

Brug venligst HeaderFirst-værdi til at indsætte header på den første side:

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

string MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.aspose.cloud/

WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

string fileName = "Sample-Document.docx";
string folder = null; // File exists at the root of the storage

// Indsæt sidehoved for den første side
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderFirst", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

og HeaderPrimary-værdi for at indsætte header på resten af siderne:

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

// Indsæt overskrift for alle andre sider
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderPrimary", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

Da den første header er forskellig fra de andre, skal du indstille DifferentFirstPageHeaderFooter-parameterværdien til sand som vist nedenfor:

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var sectionIndex = 0;
var body = new PageSetup
{
    DifferentFirstPageHeaderFooter = true
};

var pageSetupRequest = new UpdateSectionPageSetupRequest(fileName, sectionIndex, body);
var actual = wordsApi.UpdateSectionPageSetup(pageSetupRequest);

Efter udførelse af ovenstående kodestykke er tomme afsnit blevet tilføjet til dokumentets overskrifter. Nu, for at tilføje tekst til disse overskrifter, vil vi bruge Insert Paragraph API. Koden vist nedenfor tilføjer “Aspose” tekst i den første header og “Cloud File Format APIs” tekst i alle andre overskrifter:

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var run = new Run { Text = "ASPOSE" };
            
var runRequest = new PutRunRequest(fileName, "sections/0/headersfooters/1/paragraphs/0", run);
var actual = wordsApi.PutRun(runRequest);

Anvend formatering på en sidehoveds tekst

Formatering kan anvendes på en overskrifts tekst ved hjælp af Update Run Font API. API’en accepterer fontDto-objekt i sin krop, hvis ressourceegenskabers detaljer er angivet i artiklen Opdater skrifttypeegenskaber for tekst i et Word-dokument. Følgende kode indstiller skrifttypefamilien til overskriftsteksten til Verdana, tekststørrelsen til 14 og tekstfarven til sort.

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 14, Color = new XmlColor { Web = "#000000" }  };

// Anvend formatering på første sidehoved
var documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

// Anvend formatering på sidehovedet på alle andre sider
documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/0/paragraphs/0", runIndex);
actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

Efter at have foretaget ovenstående API-kald, ser inputdokumentet ud som følger:

Indsæt sidetal i et Word-dokument

InsertPageNumbers API bruges til at indsætte sidetal i et Word-dokument. API’en accepterer følgende JSON-objekt i sin krop:

{
  "Format": "string",
  "Alignment": "string",
  "IsTop": true,
  "SetPageNumberOnFirstPage": true
}

Da vi tilføjer sidetal i overskriften, sætter vi IsTop-parameterens værdi til sand. For at tilføje sidetal i sidefoden skal du dog indstille værdien til falsk.

// For et komplet eksempel og datafil, gå til https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = true, SetPageNumberOnFirstPage = true };

var insertPageNumbersRequest = new PostInsertPageNumbersRequest(fileName, body);
var actual = wordsApi.PostInsertPageNumbers(insertPageNumbersRequest);

Endelig har vi tilføjet overskrifter og sidetal til dokumentet.

Foreslået indlæg:

Vi anbefaler også, at du gennemgår følgende blogindlæg for at lære mere om:

Indsæt overskrift i et Word-dokument#

Anvend formatering på en sidehoveds tekst#

Indsæt sidetal i et Word-dokument#

Foreslået indlæg:#

Indsæt overskrift i et Word-dokument

Anvend formatering på en sidehoveds tekst

Indsæt sidetal i et Word-dokument

Foreslået indlæg: