A quick view of MS Word document transformation.
A fejléc minden oldal felső margója, a lábléc pedig minden oldal alsó margója. A fejlécek és láblécek hasznosak a dokumentum minden oldalán megjeleníteni kívánt információk megadásához, például az Ön neve, dátumai, a dokumentum címe, oldalszámok vagy a dokumentumokra vonatkozó felelősség kizárásai. Az MS Word használatakor lehetőséget biztosít fejlécek és láblécek hozzáadására előre meghatározott elrendezések alapján, vagy lehetővé teszi egyéni fejlécek és láblécek hozzáadását. A legtöbb beépített fejléc tartalmaz néhány helyőrző szöveget, és megtarthatja a helyőrző szöveget, vagy lecserélheti saját adattáblázatára. Ezenkívül a fejléc vagy lábléc szakasz információinak frissítésekor a dokumentum főtörzsén belüli tartalom szürkén jelenik meg, ami azt jelzi, hogy ezek az objektumok teljesen el vannak szigetelve az oldal többi részétől, és az ezeken az objektumokon végzett műveletek ezekre a területekre jellemzőek. Ebben a cikkben megtudjuk, hogyan lehet hozzáadni vagy frissíteni a fejléc láblécét a Word dokumentumban a REST API használatával.
Szövegszerkesztő API
Az Aspose.Words Cloud API lehetőséget biztosít MS Word fájlok betöltésére a felhőtárhelyről, valamint lehetővé teszi a felhasználó számára, hogy a bemeneti fájlt közvetlenül a kérés törzsében adja át, az API pedig a frissített fájlt adja vissza a válaszobjektumban. Biztosítja az egyes vagy az összes fejléc- és láblécobjektum olvasását, hozzáadását, frissítését vagy törlését. Ezenkívül azt is megadhatja, hogy az első oldalhoz és a páratlan/páratlan oldalakhoz különböző fejléceket/lábléceket jelenítsen meg.
Ezenkívül az API lehetővé teszi a formázási információk, például a betűtípus és a bekezdés tulajdonságainak beállítását a fejléc/lábléc szövegéhez. Azt is kihasználhatja, hogy dinamikus oldalszámokat szúrjon be a fejléc/lábléc részbe. Végül, de nem utolsósorban, érdemes lehet táblázatobjektumokat használni, hogy a fejléc/lábléc szövegének egyik részét a bal, a másikat pedig a jobb szélhez igazítsa.
A cikk hatálya
Az Aspose.Words Cloud SDK for .NET lehetővé teszi, hogy gyorsan és egyszerűen dolgozzon az Aspose.Words Cloud REST API-kkal, mivel sok alacsony szintű részletet kezel a kérelmek benyújtásával és a válaszok kezelésével kapcsolatban, és lehetővé teszi, hogy az üzleti követelményeknek megfelelő kód írására összpontosítson. Ebben a cikkben az Aspose.Words Cloud SDK for .NET alkalmazást fogjuk használni a Visual Studio for Mac alkalmazásban. Ez a bejegyzés meghatározza a fejléc láblécének beszúrásának lépéseit a Word-dokumentumban, ahol az egyéni formázás meg lesz határozva. Ezután a kilépő lábléc tartalom formázása frissül, és az oldalszám információ beszúrásra kerül a jobb alsó pozícióba. Mindezeket a műveleteket a felhőben hajtják végre.
Telepítés
A kezdéshez először telepítenie kell a Visual Studio-t a rendszerére. Hozzon létre egy mintamegoldást, és adja hozzá az Aspose.Words Cloud SDK for .NET NuGet-referenciáját. Tehát hivatkozás hozzáadásához kattintson a jobb gombbal a megoldásra, és válassza a NuGet csomagok kezelése… menüpontot. Írja be az Aspose.Words-Cloud kifejezést a keresőmezőbe. Válassza ki a lehetőséget, majd kattintson a Csomag hozzáadása gombra.
Most Aspose.Words.Cloud.Sdk hivatkozás jelenik meg a megoldásban. A felhő API-k használatának van néhány előnye a helyszíni (aspose.com) API-kkal szemben. Ennek az az oka, hogy nem kell manuálisan nyomon követnie és frissítenie az API-verziókat, és nem kell fizetnie a teljes licencért.
Aspose.Cloud Dashboard
Egyszerűen hozzon létre egy fiókot az Aspose.Cloud irányítópulton, vagy regisztráljon meglévő Google- vagy GitHub-fiókján keresztül, és kezdje el használni Cloud API-jainkat. A felhő API-k másik csodálatos tulajdonsága, hogy bármilyen platformon, bármilyen támogatott nyelven használhatja őket.
Ahogy fentebb jeleztük, a cikk az MS Word dokumentumokon belüli fejléc és lábléc objektumok hozzáadásával és frissítésével kapcsolatos lehetőségeket hangsúlyozza. A tesztelés kedvéért egy meglévő MS Word dokumentumsablont használtunk Business Letter néven. A dokumentumot fel kell tölteni az Aspose felhőtárhelyére, és minden manipuláció és dokumentumfeldolgozás a felhőn keresztül történik. Az összes feldolgozás befejezése után az eredményül kapott fájlmásolatot is letölthetjük a felhőtárhelyről.
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
Az Aspose.Cloud API-k használatához most az alkalmazáskulcsot és az alkalmazás SID-információit kell használnia a kódban. Ezek a billentyűk alfanumerikus számjegyekből állnak. Ezek az Ön előfizetési fiókjához társított egyedi kódok. A részletek megtekintéséhez kattintson a Saját alkalmazások fülre az Aspose.Cloud dashboard oldalon. Miután megvannak a kulcsok, inicializálnunk kell az Aspose.Words API objektumot.
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);
Fejléc objektum beszúrása
Ahhoz, hogy a fejléc objektumot hozzáadhassuk az MS Word fájlhoz, a következő műveleteket kell végrehajtanunk egymás után.
- Hozzon létre egy InsertHeaderFooterRequest objektumot, ahol a HeaderFooterLink típust argumentumként adjuk át.
- Helyezze be a HeaderFooterRequest objektumot a WordsApi objektumba az InsertHeaderFooter (…) metódussal.
- Hozzon létre egy Run objektumot, amely minta szöveges információkat tartalmaz.
- Hozzon létre InsertRunRequest objektumot, ahol átadjuk a bekezdés (SectionPath) hivatkozását a HeaderFooter objektumban, ahol a Run szöveget kell hozzáadni.
Ezután hívja meg a WordsApi InsertRun (…) metódust, amely hozzáadja a RunRequest-et a HeaderFooter objektumhoz.
A HeaderFooter.TypeEnum a következő értékek egyike lehet.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// hozzon létre egy WordsAPI objektumot az AppKey és AppSid információk átadása közben
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// mintadokumentum feltöltése felhőtárhelyre
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Fejléc objektum beszúrása az első oldalra
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Hozzon létre minta szöveget tartalmazó Run objektumot
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// adja hozzá a Run szöveget az első HeaderFooter objektum első bekezdéséhez a Word dokumentum első szakaszában
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// Illessze be a RunRequest parancsot a Word dokumentumba
var actual2 = wordsApi.InsertRun(runRequest);
Image showing preview of recently added Header
Frissítse az újonnan beillesztett fejléc szövegformázását
A fejléc objektum hozzáadása után frissíthetjük a benne lévő tartalom szövegformázását. Ennek a követelménynek a teljesítéséhez a következő lépéseket kell végrehajtanunk.
- Hozzon létre egy Font osztály objektumot, ahol megadjuk a betűtípus nevét, méretét, színinformációit.
- Annak érdekében, hogy a szöveg jobban ábrázolható legyen, jelölje be az Engrave tulajdonságot True-ként.
- Hozzon létre egy objektumot az UpdateRunFontRequest osztályból, ahol argumentumként adjuk át a bemeneti fájlt, a Font, a SectionPath és a runIndexet.
- Végül használja az UpdateRunFont(..) metódust, és adja hozzá az UpdateRunFontRequest objektumot a WordsApi-példányhoz.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// hozzon létre egy WordsAPI objektumot az AppKey és AppSid információk átadása közben
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// mintadokumentum feltöltése felhőtárhelyre
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// A következő lépés a fejlécobjektum formázásának beállítása
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
// Állítsa be a szöveg formázását gravírozásként
fontDto.Engrave = true;
// Alkalmazza a formázást a HeaderFooter objektum első bekezdésére
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.
Frissítse a meglévő Footer objektum formázását
Az API azt a funkciót is kínálja, hogy frissítse a meglévő fejléc/lábléc objektumon belüli tartalom formázását. Ennek a követelménynek a teljesítéséhez használhatjuk a fent megadott kódsorokat, de az egyetlen különbség a fejlécláb indexének 2-re váltása. Lásd a következő kódsort.
// 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.
Adja hozzá az oldalszám információkat a lábléc szakaszhoz
Az oldalszámok nagyon hasznos információkkal szolgálnak, például az aktuális oldalról és a dokumentum összes oldalának számáról. A következő lépések határozzák meg, hogyan kell teljesíteni a követelményeket.
- Először hozzon létre egy objektumot a PageNumber osztályból, ahol meghatározzuk a szöveg igazítását, a szöveg formátumát, az oldalszám információ megjelenítésének helyét, valamint azt is, hogy az oldalszámot az első oldalon kell-e megjeleníteni vagy sem.
- Hozzon létre InsertPageNumberRequest objektumot, és adja át a PageNumber objektumot argumentumként.
- Végül hívja meg az InsertPageNumbers(..) metódust az InsertPageNumbersRequest hozzáadásához a WordsApi példányhoz.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// hozzon létre egy WordsAPI objektumot az AppKey és AppSid információk átadása közben
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// mintadokumentum feltöltése felhőtárhelyre
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Az API azt a funkciót is kínálja, hogy oldalszámadatokat adjon hozzá a HeaderFooter objektumhoz
// Adja hozzá az oldalszámadatokat az oldal jobb alsó sarkában
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);
// Illessze be az oldalszám információkat a Word dokumentumba
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
Preview Page number in the footer section.
Következtetés
Ebből a cikkből megismertük a fejléc lábléc hozzáadásának lépéseit a Word-dokumentumban az Aspose.Words Cloud SDK for .NET használatával. Felhívjuk figyelmét, hogy a Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android rendszerekhez is rendelkezésre állnak felhő SDK-k. További részletekért keresse fel az Aspose.Words Cloud webhelyet.
Kapcsolódó cikkek
Javasoljuk továbbá, hogy látogassa meg az alábbiakat, ha többet szeretne megtudni erről: