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