הוסף כותרות ומספרי עמודים במסמך Word

הכותרת היא קטע של המסמך המופיע בשוליים העליונים ובדרך כלל מכיל מידע כגון מספר העמוד, התאריך ושם המסמך. עם Aspose.Words REST APIs ניתן להוסיף מספר עמוד במסמך Word וכן כותרות עמודים. כברירת מחדל, הכותרות זהות בכל עמוד, אך אנו יכולים ליצור כותרות שונות עבור עמודים אי-זוגיים וזוגיים.

פוסט זה נועד להשיג את הפריסה הבאה של המסמך, שבה הכותרת בעמוד הראשון שונה משאר העמודים:

לפני שנתקשר לכל Aspose REST API, עלינו ליצור חשבון Aspose Cloud ולהשיג את מפתח האפליקציה ו-SID האפליקציה שלנו. מאמר תחילת העבודה מסביר כיצד לבצע את השלבים הללו.

יתרה מכך, עלינו להעלות את המסמך לדוגמה ל-Cloud Storage שכן כל הפעולות במסמך יבוצעו בענן:

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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";

// העלה מסמך מקור ל-Cloud Storage
PutCreateRequest request = new PutCreateRequest(fileName, File.OpenRead(@"c:\Data\" + fileName), null, null);
storageApi.PutCreate(request);

הוסף כותרת במסמך Word

Insert Header Footer API מוסיף כותרות במסמך והפרמטר headerFooterType שלו יכול לקבל אחד מששת הערכים הבאים:

HeaderFirst - כותרת ראשית לעמוד הראשון של המדור.

HeaderPrimary - כותרת ראשית, משמשת גם לדפים אי-זוגיים.

HeaderEven - כותרת עליונה לדפים זוגיים.

FooterFirst - כותרת תחתונה לעמוד הראשון של המדור.

FooterPrimary - כותרת תחתונה ראשית, משמשת גם לדפים אי-זוגיים.

FooterEven - כותרת תחתונה לדפים זוגיים.

אנא השתמש בערך HeaderFirst כדי להוסיף כותרת בעמוד הראשון:

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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

// הוסף כותרת עליונה עבור העמוד הראשון
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderFirst", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

וערך HeaderPrimary כדי להוסיף כותרת בשאר הדפים:

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet/blob/master/Examples/Aspose.Words.Cloud.Sdk.Examples/HeaderFooter /InsertHeadersAndPageNumbersToAWordDocument.cs

// הוסף כותרת עבור כל שאר הדפים
var putHeaderFooterRequest = new PutHeaderFooterRequest(fileName, "HeaderPrimary", folder);
var actual = wordsApi.PutHeaderFooter(putHeaderFooterRequest);

מכיוון שהכותרת הראשונה שונה מהאחרות, הגדר את ערך הפרמטר DifferentFirstPageHeaderFooter ל-true כפי שמוצג להלן:

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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);

לאחר ביצוע קטע הקוד לעיל, נוספו פסקאות ריקות לכותרות המסמך. כעת, כדי להוסיף טקסט לכותרות אלו, נשתמש ב- Insert Paragraph API. הקוד המוצג להלן הוא הוספת טקסט “Aspose” בכותרת הראשונה וטקסט “ממשקי API של פורמט קבצי ענן” בכל שאר הכותרות:

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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);

החל עיצוב על טקסט של כותרת

ניתן להחיל עיצוב על טקסט של כותרת באמצעות ממשק API של Update Run Font. ה-API מקבל אובייקט fontDto בגוף שלו, שפרטי ה-Resource Properties שלו ניתנים במאמר עדכון מאפייני גופן עבור טקסט במסמך Word. הקוד הבא מגדיר את משפחת הגופנים של טקסט הכותרת ל-Verdana, את גודל הטקסט ל-14 ואת צבע הטקסט לשחור.

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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" }  };

// החל עיצוב על כותרת העמוד הראשון
var documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

// החל עיצוב על הכותרת העליונה של כל שאר הדפים
documentParagraphRunFontRequest = new PostDocumentParagraphRunFontRequest(fileName, fontDto, "sections/0/headersfooters/0/paragraphs/0", runIndex);
actual = wordsApi.PostDocumentParagraphRunFont(documentParagraphRunFontRequest);

לאחר ביצוע קריאות ה-API לעיל, מסמך הקלט נראה כך:

הוסף מספרי עמודים במסמך Word

InsertPageNumbers ממשק API משמש להוספת מספרי עמודים במסמך Word. ה-API מקבל את אובייקט ה-JSON הבא בגוף שלו:

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

מכיוון שאנו מוסיפים מספרי עמודים בכותרת, נגדיר את הערך של פרמטר IsTop ל-true. עם זאת, כדי להוסיף מספרי עמודים בכותרת התחתונה, הגדר את הערך ל-false.

// לקבלת דוגמה מלאה וקובץ נתונים, נא עבור אל 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);

לבסוף, הוספנו כותרות ומספרי עמודים למסמך.

פוסט מוצע:

אנו ממליצים גם לעיין בפוסטים הבאים בבלוג כדי ללמוד עוד על:

הוסף כותרת במסמך Word#

החל עיצוב על טקסט של כותרת#

הוסף מספרי עמודים במסמך Word#

פוסט מוצע:#

הוסף כותרת במסמך Word

החל עיצוב על טקסט של כותרת

הוסף מספרי עמודים במסמך Word

פוסט מוצע: