ضبط رؤوس وأسافل

رؤوس وأسافل هي سطور النص المعروضة أسفل هامش الأعلى أو أعلى الهامش على التوالي. يمكن إضافة رؤوس وأسافل إلى الأوراق العمل أيضًا. يمكن استخدام رؤوس وأسافل لعرض معلومات مفيدة مثل رقم الصفحة أو اسم المؤلف أو اسم الموضوع أو التاريخ والوقت. يتم إدارة الرؤوس والأسافل باستخدام إعدادات تخطيط الصفحة.

ضبط رؤساء الصفحات وتذايلها

يتيح Aspose.Cells لك إضافة رؤوس وتذييلات للصفحات بناءً على النموذج أو الإعداد الذي تم تصميمه مسبقًا للطباعة، ولكنها موصى بها يدوياً. يمكنك استخدام Microsoft Excel كأداة لواجهة رسومية (GUI) لتعيين رؤوس وتذييلات لتوفير الجهد والوقت في التطوير. يمكن ل Aspose.Cells استيراد الملف وحفظ الإعدادات.

لإضافة رؤوس وتذييلات بناءً على النموذج، يوفر Aspose.Cells استدعاءات API خاصة وأوامر سكريبت لتنسيق الرؤوس والتذييلات.

أوامر السكريبت

أوامر السكريبت هي أوامر خاصة تسمح لك بتعيين تنسيقات الرأس والتذييل.

أوامر السكريبت	الوصف
&P	- رقم الصفحة الحالية
&G	- صورة
&N	- مجموع عدد الصفحات
&D	- التاريخ الحالي
&T	- الوقت الحالي
&A	- اسم ورقة العمل
&F	- اسم الملف بدون مساره
&"<FontName>"	- يمثل اسم الخط. على سبيل المثال: &“Arial”
&"<FontName>, <FontStyle>"	- يمثل اسم الخط بالنمط. مثال: &“Arial,Bold”
&<FontSize>	- يمثل حجم الخط. على سبيل المثال: “&14abc”. ولكن، إذا تبعت هذه الأمر برقم عادي يتم طباعته في الرأس، يجب أن يتم فصله بحرف مسافة عن حجم الخط. على سبيل المثال: “&14 123”.

تعيين رؤوس وتذييلات

يوفر PageSetup فئتين، SetHeader و SetFooter، تُستخدم لإضافة رأس وتذيل لورقة عمل. هذه الفئات تأخذ فقط معلمتين:

• القسم – القسم الذي يجب وضع الرأس أو التذيل فيه. هناك ثلاثة أقسام: اليسار، الوسط، واليمين، يُمثلون بالترتيب 0، 1، و2.
• السكريبت – السكريبت الذي يجب استخدامه للرأس أو التذيل. يتضمن هذا السكريبت أوامر سكريبت لتنسيق الرؤوس أو التذيلات.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

// Instantiating a Workbook object
Workbook excel = new Workbook();

// Obtaining the reference of the PageSetup of the worksheet
PageSetup pageSetup = excel.Worksheets[0].PageSetup;

// Setting worksheet name at the left section of the header
pageSetup.SetHeader(0, "&A");

// Setting current date and current time at the centeral section of the header
// and changing the font of the header
pageSetup.SetHeader(1, "&\"Times New Roman,Bold\"&D-&T");

// Setting current file name at the right section of the header and changing the
// font of the header
pageSetup.SetHeader(2, "&\"Times New Roman,Bold\"&12&F");

// Setting a string at the left section of the footer and changing the font
// of a part of this string ("123")
pageSetup.SetFooter(0, "Hello World! &\"Courier New\"&14 123");

// Setting the current page number at the central section of the footer
pageSetup.SetFooter(1, "&P");

// Setting page count at the right section of footer
pageSetup.SetFooter(2, "&N");

// Save the Workbook.
excel.Save("SetHeadersAndFooters_out.xls");

إدراج صورة في رأس أو تذيل

يوجد في الفئة PageSetup طريقتان إضافيتان، SetHeaderPicture و SetFooterPicture، تُستخدم لإضافة الصور إلى الرأس والتذييل. تأخذ هذه الطرق المعاملات التالية:

• القسم – القسم الخطوط العليا أو السفلية حيث سيتم وضع الصورة. هناك ثلاثة أقسام، اليمين، الوسط واليسار، يُمثلها القيم 0، 1 و 2 على التوالي.
• مصفوفة بايت – البيانات الرسومية (يجب كتابة البيانات الثنائية في مخزن مصفوفة بايت).

بعد تنفيذ الكود أدناه وفتح الملف، تحقق من رأس الصفحة في ورقة العمل عن طريق:

1. في قائمة ملف, حدد إعداد الصفحة. سيتم عرض مربع حواري.
2. حدد علامة التبويب رأس / تذييل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a Workbook object
Workbook workbook = new Workbook();

// Creating a string variable to store the url of the logo/picture
string logo_url = dataDir + "aspose-logo.jpg";

// Declaring a FileStream object
FileStream inFile;

// Declaring a byte array
byte[] binaryData;

// Creating the instance of the FileStream object to open the logo/picture in the stream
inFile = new System.IO.FileStream(logo_url, System.IO.FileMode.Open, System.IO.FileAccess.Read);

// Instantiating the byte array of FileStream object's size
binaryData = new Byte[inFile.Length];

// Reads a block of bytes from the stream and writes data in a given buffer of byte array.
long bytesRead = inFile.Read(binaryData, 0, (int)inFile.Length);

// Creating a PageSetup object to get the page settings of the first worksheet of the workbook
PageSetup pageSetup = workbook.Worksheets[0].PageSetup;

// Setting the logo/picture in the central section of the page header
pageSetup.SetHeaderPicture(1, binaryData);

// Setting the script for the logo/picture
pageSetup.SetHeader(1, "&G");

// Setting the Sheet's name in the right section of the page header with the script
pageSetup.SetHeader(2, "&A");

// Saving the workbook
workbook.Save(dataDir + "InsertImageInHeaderFooter_out.xls");

//Closing the FileStream object
inFile.Close();