A fejléc a dokumentum egy része, amely a felső margón jelenik meg, és általában olyan információkat tartalmaz, mint az oldalszám, a dátum és a dokumentum neve. Az Aspose.Words REST API-kkal beszúrhat oldalszámot a Word dokumentumba, valamint oldalfejléceket. Alapértelmezés szerint a fejlécek minden oldalon azonosak, de a páratlan és a páros oldalakhoz más-más fejlécet készíthetünk.

Ez a bejegyzés a dokumentum következő elrendezését kívánja elérni, amelyben az első oldalon lévő fejléc eltér a többi oldaltól:

Írja be az oldalszámot
Fejléc beszúrása

Mielőtt bármelyik Aspose REST API-t meghívnánk, létre kell hoznunk Aspose Cloud-fiókot, és be kell szereznünk az alkalmazáskulcsot és az alkalmazás SID-t. Az Első lépések cikk elmagyarázza, hogyan kell végrehajtani ezeket a lépéseket.

Ezenkívül fel kell töltenünk a mintadokumentumot a Cloud Storage-be, mivel a dokumentumon végzett összes művelet a felhőben történik:

// A teljes példa és adatfájl megtekintéséhez keresse fel a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter webhelyet. /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";

// Töltse fel a forrásdokumentumot a Cloud Storage szolgáltatásba
PutCreateRequest request = new PutCreateRequest(fileName, File.OpenRead(@"c:\Data\" + fileName), null, null);
storageApi.PutCreate(request);

Fejléc beszúrása Word dokumentumba

Insert Header Footer Az API fejléceket ad hozzá a dokumentumhoz, és a headerFooterType paramétere a következő hat érték egyikét veheti fel:

  • HeaderFirst - Fejléc a szakasz első oldalához.
  • HeaderPrimary - Elsődleges fejléc, páratlan számú oldalakhoz is használatos.
  • HeaderEven - Fejléc páros számú oldalakhoz.
  • FooterFirst - Lábléc a szakasz első oldalához.
  • FooterPrimary - Elsődleges lábléc, páratlan számú oldalakhoz is használatos.
  • FooterEven - Lábléc páros számú oldalakhoz.

Kérjük, használja a HeaderFirst értéket a fejléc beszúrásához az első oldalra:

// A teljes példa és adatfájl megtekintéséhez látogasson el a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter oldalra. /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

// Helyezze be az első oldal fejlécét
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderFirst", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

és a HeaderPrimary értéket a fejléc beillesztéséhez a többi oldalra:

// A teljes példa és adatfájl megtekintéséhez látogasson el a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter oldalra. /InsertHeadersAndPageNumbersToAWordDocument.cs

// Fejléc beszúrása az összes többi oldalhoz
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderPrimary", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

Mivel az első fejléc eltér a többitől, állítsa a DifferentFirstPageHeaderFooter paraméter értékét igazra az alábbiak szerint:

// A teljes példa és adatfájl megtekintéséhez keresse fel a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter webhelyet. /InsertHeadersAndPageNumbersToAWordDocument.cs

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

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

A fenti kódrészlet végrehajtása után üres bekezdések kerültek a dokumentum fejlécébe. Most, hogy szöveget adjunk ezekhez a fejlécekhez, a Beszúrás beszúrása API-t fogjuk használni. Az alább látható kód „Aspose” szöveget ad az első fejléchez, és „Cloud File Format APIs” szöveget az összes többi fejléchez:

// A teljes példa és adatfájl megtekintéséhez keresse fel a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter webhelyet. /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);

Alkalmazza a formázást a fejléc szövegére

A formázás alkalmazható a fejléc szövegére az Update Run Font API használatával. Az API elfogadja a fontDto objektumot a törzsében, amelynek erőforrás-tulajdonságait a Frissítse a betűtípus tulajdonságait Word-dokumentum szövegéhez cikkben találja. A következő kód a fejléc szövegének betűcsaládját Verdana-ra, a szöveg méretét 14-re és a szöveg színét feketére állítja.

// A teljes példa és adatfájl megtekintéséhez keresse fel a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter webhelyet. /InsertHeadersAndPageNumbersToAWordDocument.cs

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

// Alkalmazza a formázást az első oldal fejlécére
var documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

// Alkalmazza a formázást az összes többi oldal fejlécére
documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/0/paragraphs/0", runIndex);
actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

A fenti API-hívások végrehajtása után a beviteli dokumentum a következőképpen néz ki:

Oldalszámok beszúrása Word dokumentumba

Az InsertPageNumbers API az oldalszámok Word-dokumentumba történő beszúrására szolgál. Az API a következő JSON-objektumot fogadja el a törzsében:

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

Mivel a fejlécben oldalszámokat adunk, az IsTop paraméter értékét igazra állítjuk. Ha azonban oldalszámokat szeretne hozzáadni a lábléchez, állítsa az értéket false értékre.

// A teljes példa és adatfájl megtekintéséhez látogasson el a https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter oldalra. /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);

Végül fejléceket és oldalszámokat adtunk a dokumentumhoz.

Ajánlott bejegyzés:

Javasoljuk továbbá, hogy tekintse át a következő blogbejegyzéseket, hogy többet megtudjon a témáról: