رقم الصفحة في تذييل الصفحة باستخدام المربع العائم

في هذا البرنامج التعليمي، سنرشدك خطوة بخطوة حول كيفية إضافة رقم الصفحة في رأس وتذييل مستند PDF باستخدام FloatingBox مع Aspose.PDF لـ .NET. سنستخدم كود مصدر C# المقدم لإنشاء مستند PDF، وإضافة صفحة، وإنشاء FloatingBox، وتعيين موضعه وإضافة رقم الصفحة إليه، ثم حفظ مستند PDF المعدل.

الخطوة 1: تهيئة البيئة

قبل أن تبدأ، تأكد من أن لديك ما يلي:

• بيئة تطوير .NET مثبتة.
• تم تنزيل مكتبة Aspose.PDF الخاصة بـ .NET والإشارة إليها في مشروعك.

الخطوة 2: إنشاء مستند PDF وإضافة صفحة

الخطوة الأولى هي إنشاء مثيل لمستند PDF وإضافة صفحة إليه. إليك الطريقة:

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// إنشاء مثيل لمستند PDF
Aspose.Pdf.Document pdf = new Aspose.Pdf.Document();

// إضافة صفحة إلى وثيقة PDF
Aspose.Pdf.Page page = pdf.Pages.Add();

تأكد من استبدال “دليل المستندات الخاص بك” بالمسار الفعلي للدليل الذي تريد حفظ مستند PDF فيه.

الخطوة 3: إنشاء FloatingBox وإضافة رقم الصفحة

الآن بعد أن تمت إضافة الصفحة إلى مستند PDF، يمكننا إنشاء FloatingBox وتعيين موضعه وإضافة رقم الصفحة إليه. إليك الطريقة:

// قم بإنشاء صندوق عائم بعرض 140 وارتفاع 80
Aspose.Pdf.FloatingBox box1 = new Aspose.Pdf.FloatingBox(140, 80);

// ضبط الموضع الأيسر للفقرة
box1. Left = 2;

// تعيين الموضع العلوي للفقرة
box1. Top = 10;

// أضف رقم الصفحة إلى FloatingBox
box1.Paragraphs.Add(new Aspose.Pdf.Text.TextFragment("Page: ($p/ $P )"));

// أضف FloatingBox إلى الصفحة
page.Paragraphs.Add(box1);

يقوم الكود أعلاه بإنشاء صندوق عائم بعرض 140 وارتفاع 80. بعد ذلك، نقوم بتعيين موضعه عن طريق تحديد القيم اليسرى والعليا. أخيرًا، نضيف رقم الصفحة إلى FloatingBox باستخدام TextFragment الذي يحتوي على الصيغة “($p/ $P )” والتي سيتم استبدالها برقم الصفحة الحالية والعدد الإجمالي للصفحات.

الخطوة 4: حفظ مستند PDF المعدل

بمجرد إضافة رقم الصفحة إلى الرأس أو التذييل باستخدام FloatingBox، يمكننا حفظ مستند PDF المعدل. إليك الطريقة:

// احفظ مستند PDF المعدل
pdf.Save(dataDir + "PageNumberinHeaderFooterUsingFloatingBox_out.pdf");

يحفظ الكود أعلاه مستند PDF المحرر في الدليل المحدد.

نموذج التعليمات البرمجية المصدر لتذييل رأس الصفحة Numberin باستخدام Floating Box باستخدام Aspose.PDF لـ .NET

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// إنشاء مثيل للمستند
Aspose.Pdf.Document pdf = new Aspose.Pdf.Document();

// أضف صفحة إلى مستند pdf
Aspose.Pdf.Page page = pdf.Pages.Add();

//تهيئة مثيل جديد لفئة FloatingBox
Aspose.Pdf.FloatingBox box1 = new Aspose.Pdf.FloatingBox(140, 80);

// القيمة العائمة التي تشير إلى الموضع الأيسر للفقرة
box1.Left = 2;

// القيمة العائمة التي تشير إلى الموضع العلوي للفقرة
box1.Top = 10;

// أضف وحدات الماكرو إلى مجموعة الفقرات في FloatingBox
box1.Paragraphs.Add(new Aspose.Pdf.Text.TextFragment("Page: ($p/ $P )"));

// أضف صندوقًا عائمًا إلى الصفحة
page.Paragraphs.Add(box1);

// احفظ المستند
pdf.Save(dataDir + "PageNumberinHeaderFooterUsingFloatingBox_out.pdf");

خاتمة

تهنئة ! لقد تعلمت كيفية إضافة رقم الصفحة في رأس وتذييل مستند PDF باستخدام FloatingBox مع Aspose.PDF لـ .NET. يمكنك الآن تخصيص الرؤوس والتذييلات الخاصة بك عن طريق إضافة معلومات ديناميكية مثل رقم الصفحة.

الأسئلة الشائعة

س: ما هو FloatingBox، وكيف يتم استخدامه لإضافة أرقام الصفحات في رأس أو تذييل مستند PDF؟

ج: يعد FloatingBox عنصر تخطيط متعدد الاستخدامات في Aspose.PDF يمكنه الاحتفاظ بمحتوى متنوع، بما في ذلك النصوص والصور. في هذا البرنامج التعليمي، يتم استخدامه لإنشاء حاوية لرقم الصفحة، مما يسمح لك بإدراج رقم الصفحة الحالية وإجمالي عدد الصفحات ديناميكيًا في الرأس أو التذييل.

س: كيف يحقق كود مصدر C# المقدم إضافة أرقام الصفحات باستخدام FloatingBox؟

ج: يوضح مقتطف الكود كيفية إنشاء مستند PDF، وإضافة صفحة، وإنشاء FloatingBox، وتعيين موضعه داخل الصفحة، وإدراج رقم الصفحة باستخدام TextFragment. يتم استبدال بناء الجملة “($p/ $P )” في TextFragment برقم الصفحة الحالية وإجمالي عدد الصفحات.

س: هل يمكنني تخصيص مظهر وتنسيق رقم الصفحة المضافة باستخدام FloatingBox؟

ج: نعم، يمكنك تخصيص مظهر رقم الصفحة عن طريق تعديل خصائص TextFragment داخل FloatingBox. يمكنك تغيير حجم الخط واللون والنمط والمحاذاة وخيارات التنسيق الأخرى.

س: هل من الممكن إضافة عناصر ديناميكية مختلفة، مثل التاريخ والوقت، إلى الرأس أو التذييل باستخدام أسلوب مماثل؟

ج: بالتأكيد، يمكنك إضافة عناصر ديناميكية مختلفة مثل التاريخ أو الوقت أو بيانات تعريف المستند أو النص المخصص عن طريق تعديل محتوى TextFragment داخل FloatingBox. يمكنك استخدام وحدات الماكرو مثل “($p/ $P )” لأرقام الصفحات أو “($date)” للتاريخ الحالي.

س: كيف يمكنني تحديد موضع FloatingBox داخل قسم الرأس أو التذييل؟

ج: يقوم الكود المقدم بتعيين موضع FloatingBox باستخدام ملفLeft وTop ملكيات. يمكنك ضبط هذه القيم لوضع FloatingBox حسب الرغبة داخل قسم الرأس أو التذييل.

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

ج: نعم، يمكنك تخصيص الخط والنمط وخصائص التنسيق الأخرى لنص رقم الصفحة عن طريق تعديل خصائص TextFragment داخل FloatingBox.

س: ماذا يحدث إذا تجاوز المحتوى الموجود في FloatingBox أبعاده؟

ج: إذا تجاوز المحتوى الموجود داخل FloatingBox أبعاده، فقد يتم قطعه أو قد تنشأ مشكلات في التخطيط. تأكد من أن أبعاد FloatingBox مناسبة لاستيعاب المحتوى، وفكر في تعديل تخطيط الصفحة إذا لزم الأمر.

س: هل من الممكن إضافة مربعات عائمة متعددة ذات محتوى مختلف إلى رأس أو تذييل الصفحة نفسها؟

ج: نعم، يمكنك إضافة عدة FloatingBoxes بمحتوى مختلف إلى رأس أو تذييل الصفحة نفسها عن طريق إنشاء مثيلات FloatingBox منفصلة وإضافتها إلى مجموعة الفقرات الخاصة بالصفحة.

س: هل يمكنني استخدام أسلوب FloatingBox لإضافة محتوى إلى أقسام أخرى من مستند PDF، مثل النص الأساسي أو الهوامش؟

ج: على الرغم من استخدام FloatingBoxes بشكل شائع للرؤوس والتذييلات، يمكنك أيضًا استخدامها لإضافة محتوى إلى أقسام أخرى من مستند PDF، مثل النص الأساسي أو الهوامش، عن طريق وضعها وفقًا لذلك داخل الصفحة.