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

API לעיבוד תמלילים

Aspose.Words Cloud API מספק את היכולות לטעון קבצי MS Word מאחסון בענן, כמו כן הוא מאפשר למשתמש להעביר את קובץ הקלט ישירות בגוף הבקשה וה-API מחזיר את הקובץ המעודכן באובייקט התגובה. הוא מספק את התכונות לקריאה, הוספה, עדכון או מחיקה של אובייקטי כותרת עליונה ותחתית ספציפיים או כל. יתרה מזאת, אתה יכול גם לציין להציג כותרות עליונות/תחתונות שונות עבור העמוד הראשון ועבור עמודים אי זוגיים/זוגיים.

יתר על כן, ה-API גם מאפשר לך להגדיר מידע עיצובי כגון מאפייני גופן ופיסקה עבור טקסט הכותרת העליונה/תחתונה. אתה גם מקבל את המינוף להכנסת מספרי עמודים דינמיים למקטע הכותרת העליונה/תחתונה. אחרון חביב, ייתכן שתשקול להשתמש באובייקטי טבלה כדי ליישר חלק אחד של הכותרת העליונה/תחתונה לטקסט לקצה השמאלי והשני לקצה הימני.

היקף המאמר

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

הַתקָנָה

כדי להתחיל, ראשית, עליך להתקין את Visual Studio במערכת שלך. צור פתרון לדוגמה והוסף התייחסות ל-NuGet של Aspose.Words Cloud SDK עבור .NET. אז על מנת להוסיף הפניה, לחץ לחיצה ימנית על הפתרון ובחר באפשרות ניהול חבילות NuGet… בתפריט. הזן את Aspose.Words-Cloud בשדה טקסט החיפוש. בחר באפשרות ולחץ על כפתור הוסף חבילה.

כעת מופיעה הפניה של Aspose.Words.Cloud.Sdk בפתרון. ישנם כמה יתרונות של שימוש בממשקי API בענן בניגוד לממשקי API מקומיים (aspose.com).הסיבה היא שאינך צריך לעקוב באופן ידני ולעדכן את גרסאות ה-API ואינך צריך לשלם עבור כל הרישיון.

Aspose.Cloud Dashboard

כל שעליך לעשות הוא ליצור חשבון ב-Aspose.Cloud Dashboard או להירשם דרך חשבון Google או GitHub הקיים שלך ולהתחיל להשתמש בממשקי הענן שלנו. תכונה מדהימה נוספת של ממשקי API של ענן היא שאתה יכול להשתמש בהם בכל פלטפורמה באמצעות כל שפה נתמכת.

כפי שצוין לעיל, המאמר מדגיש אפשרויות לגבי הוספה ועדכון של אובייקטי Header ו-Footer בתוך מסמכי MS Word. לצורך הבדיקה, השתמשנו בתבנית מסמך MS Word קיימת בשם Business Letter. יש להעלות את המסמך לאחסון בענן של Aspose וכל המניפולציות ועיבוד המסמכים יבוצעו מעל הענן. לאחר השלמת כל העיבוד, נוכל גם להוריד את עותק הקובץ שנוצר מאחסון הענן.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

כעת כדי להשתמש בממשקי API של Aspose.Cloud, עליך להשתמש במידע על מפתח אפליקציה ו-App SID בקוד שלך. מפתחות אלה מורכבים מספרות אלפאנומריות. אלו הם קודים ייחודיים המשויכים לחשבון המנוי שלך. על מנת לקבל פרטים אלה, אנא לחץ על הכרטיסייה ‘האפליקציות שלי’ ב-מרכז השליטה של Aspose.Cloud. ברגע שיש לנו את המפתחות, עלינו לאתחל את אובייקט Aspose.Words API.

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);

הוסף אובייקט כותרת

על מנת להוסיף את אובייקט הכותרת בתוך קובץ MS Word, עלינו לבצע את הפעולות הבאות ברצף.

  1. צור אובייקט של InsertHeaderFooterRequest שבו נעביר את סוג HeaderFooterLink כארגומנט.
  2. הוסף אובייקט HeaderFooterRequest לאובייקט WordsApi באמצעות שיטת InsertHeaderFooter (…).
  3. צור אובייקט הפעלה המכיל מידע טקסט לדוגמה.
  4. צור אובייקט InsertRunRequest שבו אנו מעבירים את ההפניה של paragraph(SectionPath) באובייקט HeaderFooter, שבו יש להוסיף טקסט הפעלה.
    לאחר מכן קרא לשיטת InsertRun (…) של WordsApi, אשר מוסיפה את האובייקט RunRequest ל-HeaderFooter.

ה-HeaderFooter.TypeEnum יכול להיות אחד מהערכים הבאים.

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// צור אובייקט של WordsAPI תוך העברת מידע AppKey ו-AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// העלה מסמך לדוגמה לאחסון בענן
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// הוסף אובייקט כותרת בעמוד הראשון
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);  
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// צור אובייקט הפעלה המכיל טקסט לדוגמה
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// הוסף את טקסט ההפעלה לפסקה הראשונה של אובייקט HeaderFooter הראשון בחלק הראשון של מסמך Word
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// הכנס את מסמך RunRequest ל-Word
var actual2 = wordsApi.InsertRun(runRequest);

עדכן את עיצוב הטקסט של הכותרת החדשה שהוכנסה

לאחר הוספת אובייקט ה-Header, נוכל לעדכן את עיצוב הטקסט של התוכן שבתוכו. על מנת לעמוד בדרישה זו, עלינו לבצע את השלבים הבאים.

  1. צור אובייקט של מחלקת גופן, שבה אנו מציינים את שם הגופן, גודלו, מידע צבע.
  2. על מנת להפוך את הטקסט ליותר ייצוגי, סמן את ה-Engrave property כ-True.
  3. צור אובייקט של מחלקה UpdateRunFontRequest שבו נעביר את קובץ הקלט, Font, SectionPath ו-runIndex כארגומנט.
  4. לבסוף, השתמש בשיטת UpdateRunFont(..) והוסף אובייקט UpdateRunFontRequest למופע WordsApi.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// צור אובייקט של WordsAPI תוך העברת מידע AppKey ו-AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// העלה מסמך לדוגמה לאחסון בענן
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// השלב הבא הוא להגדיר עיצוב של אובייקט כותרת
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
//  הגדר עיצוב של טקסט בתור חריטה
fontDto.Engrave = true;
// החל עיצוב על הפסקה הראשונה של אובייקט HeaderFooter
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);

עדכון עיצוב של אובייקט כותרת תחתונה קיים

ה-API מציע גם את התכונה לעדכן את העיצוב של תוכן בתוך אובייקט Header / Footer הקיים. על מנת למלא את הדרישה הזו, אנו יכולים להשתמש בשורות הקוד שצוינו לעיל, אך ההבדל היחיד הוא שינוי אינדקס כותרת תחתונה ל-2. ראה את שורת הקוד הבאה.

// 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);

הוסף מידע על מספר עמודים בקטע כותרת תחתונה

מספרי עמודים מספקים מידע שימושי מאוד כמו העמוד הנוכחי והמספר הכולל של עמודים במסמך. השלבים הבאים מגדירים כיצד לעמוד בדרישות.

  1. תחילה צור אובייקט של מחלקה PageNumber, שם אנו מגדירים, יישור טקסט, פורמט הטקסט, מיקום לרינדור מידע PageNumber וגם, לציין אם יש לעבד את PageNumber בעמוד הראשון או לא.
  2. צור אובייקט InsertPageNumbersRequest והעברת אובייקט PageNumber כארגומנט.
  3. לבסוף, קרא לשיטת InsertPageNumbers(..) כדי להוסיף InsertPageNumbersRequest למופע WordsApi.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// צור אובייקט של WordsAPI תוך העברת מידע AppKey ו-AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// העלה מסמך לדוגמה לאחסון בענן
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// ה-API מציע גם את התכונה להוסיף פרטי מספר עמוד באובייקט HeaderFooter
// הוסף מידע על מספר עמוד בתחתית העמוד מימין
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);
// הוסף מידע על מספר עמודים בתוך מסמך Word
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);

מַסְקָנָה

במאמר זה, למדנו את השלבים כיצד להוסיף כותרת תחתונה במסמך Word באמצעות Aspose.Words Cloud SDK עבור .NET. שים לב שיש לנו גם ערכות SDK של ענן זמינות עבור Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android. לפרטים נוספים, בקר ב-Aspose.Words Cloud.

מאמרים קשורים

אנו ממליצים גם לבקר באתר הבא כדי ללמוד עוד על