التسمية التوضيحية

A quick view of MS Word document transformation.

يُعد الرأس هو الهامش العلوي لكل صفحة، والتذييل هو الهامش السفلي لكل صفحة. تعد الرؤوس والتذييلات مفيدة لإدراج المعلومات التي تريد عرضها على كل صفحة من المستند مثل اسمك أو التواريخ أو عنوان المستند أو أرقام الصفحات أو إخلاء المسؤولية للمستندات. عند استخدام MS Word، فإنه يوفر الإمكانيات لإضافة الرأس والتذييلات بناءً على تخطيطات محددة مسبقًا أو يمكّنك من إضافة رؤوس وتذييلات مخصصة. تحتوي معظم الرؤوس المضمنة على بعض النصوص المؤقتة ويمكنك إما الاحتفاظ بالنص المؤقت أو استبداله بموجز البيانات الخاص بك. أيضًا، عند تحديث المعلومات في قسم الرأس أو التذييل، يكون المحتوى داخل النص الرئيسي للمستند باللون الرمادي مما يشير إلى أن هذه الكائنات معزولة تمامًا عن بقية محتوى الصفحة وأن العملية التي تقوم بها على هذه الكائنات خاصة بهذه المناطق. في هذه المقالة، سنتعلم الخطوات حول كيفية إضافة أو تحديث الرأس والتذييل في مستند Word باستخدام واجهة برمجة تطبيقات REST.

واجهة برمجة تطبيقات معالجة الكلمات

توفر Aspose.Words Cloud API الإمكانيات اللازمة لتحميل ملفات MS Word من التخزين السحابي، كما تسمح للمستخدم بتمرير ملف الإدخال مباشرة في نص الطلب وتعيد واجهة برمجة التطبيقات الملف المحدث في كائن الاستجابة. كما توفر الميزات اللازمة لقراءة أو إضافة أو تحديث أو حذف كائنات رأس وتذييل معينة أو كلها. علاوة على ذلك، يمكنك أيضًا تحديد عرض رؤوس/تذييلات مختلفة للصفحة الأولى والصفحات الفردية/الزوجية.

علاوة على ذلك، تتيح لك واجهة برمجة التطبيقات أيضًا تعيين معلومات التنسيق مثل خصائص الخط والفقرة لنص الرأس/التذييل. كما يمكنك أيضًا الحصول على القدرة على إدراج أرقام الصفحات الديناميكية في قسم الرأس/التذييل. وأخيرًا وليس آخرًا، يمكنك التفكير في استخدام كائنات الجدول لجعل جزء من نص الرأس/التذييل محاذيًا للحافة اليسرى والجزء الآخر للحافة اليمنى.

نطاق المادة

تتيح لك Aspose.Words Cloud SDK for .NET العمل مع Aspose.Words Cloud REST APIs بسرعة وسهولة، حيث إنها تتولى الكثير من التفاصيل منخفضة المستوى فيما يتعلق بتقديم الطلبات ومعالجة الاستجابات وتتيح لك التركيز على كتابة التعليمات البرمجية الخاصة بمتطلبات عملك. في هذه المقالة، سنستخدم Aspose.Words Cloud SDK for .NET في Visual Studio for Mac. تحدد هذه المقالة الخطوات اللازمة لإدراج رأس وتذييل الصفحة في مستند Word حيث سيتم تعريف التنسيق المخصص. ثم يتم تحديث تنسيق محتوى التذييل الموجود وإدراج معلومات PageNumber في الموضع السفلي الأيمن. سيتم تنفيذ كل هذه العمليات في السحابة.

تثبيت

للبدء، تحتاج أولاً إلى تثبيت Visual Studio على نظامك. قم بإنشاء حل نموذجي وأضف مرجع NuGet الخاص بـ Aspose.Words Cloud SDK for .NET. لذا لإضافة مرجع، انقر بزر الماوس الأيمن فوق الحل وحدد خيار القائمة Manage NuGet Packages… (إدارة حزم NuGet…).أدخل Aspose.Words-Cloud في حقل نص البحث. حدد الخيار وانقر فوق الزر Add package (إضافة حزمة).

الآن يظهر مرجع Aspose.Words.Cloud.Sdk في الحل. هناك بعض الفوائد لاستخدام واجهات برمجة التطبيقات السحابية على النقيض من واجهات برمجة التطبيقات المحلية (aspose.com).والسبب هو أنك لست بحاجة إلى تتبع إصدارات واجهة برمجة التطبيقات وتحديثها يدويًا ولا تحتاج إلى دفع ثمن الترخيص بالكامل.

لوحة تحكم Aspose.Cloud

ما عليك سوى إنشاء حساب على لوحة تحكم Aspose.Cloud أو التسجيل من خلال حسابك الحالي على Google أو GitHub والبدء في استخدام واجهات برمجة التطبيقات السحابية الخاصة بنا. ومن الميزات المذهلة الأخرى لواجهات برمجة التطبيقات السحابية أنه يمكنك استخدامها على أي منصة باستخدام أي لغة مدعومة.

كما هو موضح أعلاه، تؤكد المقالة على الخيارات المتعلقة بإضافة وتحديث كائنات الرأس والتذييل داخل مستندات 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;

الآن، لاستخدام واجهات برمجة تطبيقات Aspose.Cloud، تحتاج إلى استخدام معلومات App Key وApp SID في الكود الخاص بك. تتكون هذه المفاتيح من أرقام أبجدية رقمية. وهي عبارة عن أكواد فريدة مرتبطة بحساب اشتراكك. للحصول على هذه التفاصيل، يرجى النقر فوق علامة التبويب My Apps في لوحة معلومات Aspose.Cloud. بمجرد حصولنا على المفاتيح، نحتاج إلى تهيئة كائن واجهة برمجة تطبيقات Aspose.Words.

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، حيث يجب إضافة نص Run.
    ثم قم باستدعاء طريقة 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);
التسمية التوضيحية

Image showing preview of recently added Header

تحديث تنسيق النص للعنوان المدرج حديثًا

بمجرد إضافة كائن Header، يمكننا تحديث تنسيق النص للمحتوى الموجود بداخله. وللوفاء بهذا المطلب، نحتاج إلى تنفيذ الخطوات التالية.

  1. إنشاء كائن من فئة الخط، حيث نحدد اسم الخط وحجمه ومعلومات اللون.
  2. من أجل جعل النص أكثر قابلية للعرض، قم بوضع علامة على خاصية النقش على 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);
التسمية التوضيحية

Image showing preview of Header after text formatting has been applied.

تحديث تنسيق كائن التذييل الحالي

توفر واجهة برمجة التطبيقات أيضًا ميزة تحديث تنسيق المحتوى داخل كائن الرأس/التذييل الحالي. وللوفاء بهذا المطلب، يمكننا استخدام أسطر التعليمات البرمجية المحددة أعلاه، ولكن الاختلاف الوحيد هو تغيير مؤشر الرأس/التذييل إلى 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);
التسمية التوضيحية

Image displaying the change in Footer text formatting.

إضافة معلومات رقم الصفحة في قسم التذييل

توفر أرقام الصفحات معلومات مفيدة للغاية مثل الصفحة الحالية والعدد الإجمالي للصفحات في المستند. تحدد الخطوات التالية كيفية تحقيق المتطلبات.

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

// توفر واجهة برمجة التطبيقات أيضًا ميزة إضافة تفاصيل رقم الصفحة في كائن 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);
التسمية التوضيحية

Preview Page number in the footer section.

خاتمة

في هذه المقالة، تعلمنا الخطوات الخاصة بكيفية إضافة رأس وتذييل في مستند Word باستخدام Aspose.Words Cloud SDK for .NET. يرجى ملاحظة أن لدينا أيضًا Cloud SDKs متاحة لـ Java وPHP وRuby وPython وGo وSwift وC++ وNode.Js وAndroid. لمزيد من التفاصيل، يرجى زيارة Aspose.Words Cloud.

مقالات ذات صلة

نوصي أيضًا بزيارة ما يلي لمعرفة المزيد عن