إدراج فاصل الصفحات في ملف PDF

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

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

تأكد من أنك قمت بتكوين بيئة تطوير C# الخاصة بك باستخدام Aspose.PDF لـ .NET. أضف المرجع إلى المكتبة واستورد مساحات الأسماء الضرورية.

الخطوة 2: إنشاء المستند والجدول

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

Document doc = new Document();
doc.Pages.Add();

Aspose.Pdf.Table tab = new Aspose.Pdf.Table();
tab.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Red);
tab.DefaultCellBorder = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Red);
tab. ColumnWidths = "100 100";

الخطوة 3: إضافة صفوف إلى الجدول

نستخدم حلقة لإضافة 200 صف إلى المصفوفة. لكل صف، نقوم بإنشاء مثيل للصف وإضافة خليتين بمحتوى نصي.

for (int counter = 0; counter <= 200; counter++)
{
     Aspose.Pdf.Row row = new Aspose.Pdf.Row();
     tab. Rows. Add(row);
    
     Aspose.Pdf.Cell cell1 = new Aspose.Pdf.Cell();
     cell1.Paragraphs.Add(new TextFragment("Cell " + counter + ", 0"));
     row. Cells. Add(cell1);
    
     Aspose.Pdf.Cell cell2 = new Aspose.Pdf.Cell();
     cell2.Paragraphs.Add(new TextFragment("Cell " + counter + ", 1"));
     row. Cells. Add(cell2);
    
     // عند إضافة 10 أسطر، نقوم بإدراج فاصل صفحة جديد
     if (counter % 10 == 0 && counter != 0)
         row. IsInNewPage = true;
}

الخطوة 4: إضافة الجدول إلى المستند

نضيف الجدول إلى مجموعة الفقرات بصفحة الوثيقة.

doc.Pages[1].Paragraphs.Add(tab);

الخطوة 5: احفظ المستند

نقوم بحفظ مستند PDF مع إدراج فاصل الصفحات.

doc.Save(dataDir + "InsertPageBreak_out.pdf");

مثال على التعليمات البرمجية المصدر لإدراج فاصل الصفحات باستخدام Aspose.PDF لـ .NET

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

// إنشاء مثيل للمستند
Document doc = new Document();
// إضافة صفحة إلى مجموعة الصفحات من ملف PDF
doc.Pages.Add();
// إنشاء مثيل الجدول
Aspose.Pdf.Table tab = new Aspose.Pdf.Table();
// تعيين نمط الحدود للجدول
tab.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Red);
// قم بتعيين نمط الحدود الافتراضي للجدول بلون الحدود باللون الأحمر
tab.DefaultCellBorder = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, Aspose.Pdf.Color.Red);
// تحديد عرض أعمدة الجدول
tab.ColumnWidths = "100 100";
// قم بإنشاء حلقة لإضافة 200 صف للجدول
for (int counter = 0; counter <= 200; counter++)
{
	Aspose.Pdf.Row row = new Aspose.Pdf.Row();
	tab.Rows.Add(row);
	Aspose.Pdf.Cell cell1 = new Aspose.Pdf.Cell();
	cell1.Paragraphs.Add(new TextFragment("Cell " + counter + ", 0"));
	row.Cells.Add(cell1); Aspose.Pdf.Cell cell2 = new Aspose.Pdf.Cell();
	cell2.Paragraphs.Add(new TextFragment("Cell " + counter + ", 1"));
	row.Cells.Add(cell2);
	// عند إضافة 10 صفوف، قم بعرض صف جديد في صفحة جديدة
	if (counter % 10 == 0 && counter != 0) row.IsInNewPage = true;
}
// إضافة جدول إلى مجموعة الفقرات من ملف PDF
doc.Pages[1].Paragraphs.Add(tab);

dataDir = dataDir + "InsertPageBreak_out.pdf";
// احفظ مستند PDF
doc.Save(dataDir);

Console.WriteLine("\nPage break inserted successfully.\nFile saved at " + dataDir);

خاتمة

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

الأسئلة الشائعة حول إدراج فاصل الصفحات في ملف PDF

س: كيف يمكنني تغيير حجم الصفحة للصفحات الجديدة التي تم إنشاؤها بعد فاصل الصفحات؟

ج: لتغيير حجم الصفحة للصفحات الجديدة التي تم إنشاؤها بعد فاصل الصفحات، يمكنك تعيينPageSize ملكيةPage هدف. على سبيل المثال، يمكنك استخدام الكود التالي لتعيين حجم الصفحة إلى A4:

// اضبط حجم الصفحة على A4
doc.Pages[1].SetPageSize(PageSize.A4);

س: هل يمكنني التحكم في هوامش الصفحة للصفحات الجديدة بعد فاصل الصفحات؟

ج: نعم، يمكنك التحكم في هوامش الصفحة للصفحات الجديدة بعد فاصل الصفحات. استخدم الMargin ملكيةPage كائن لتعيين هوامش الصفحة. على سبيل المثال، لتعيين كافة الهوامش إلى 10 نقاط، يمكنك استخدام الكود التالي:

// اضبط جميع الهوامش على 10 نقاط
doc.Pages[1].Margin = new MarginInfo(10, 10, 10, 10);

س: هل من الممكن إضافة رؤوس وتذييلات للصفحات الجديدة بعد فاصل الصفحات؟

ج: نعم، يمكنك إضافة رؤوس وتذييلات للصفحات الجديدة بعد فاصل الصفحات. استخدم الPage.Header وPage.Footer خصائص لإضافة محتوى إلى أقسام الرأس والتذييل في الصفحة. على سبيل المثال:

// أضف رأسًا إلى الصفحات الجديدة
doc.Pages[1].Header = new HeaderFooter()
{
    Margin = new MarginInfo(10, 10, 10, 10),
    Paragraphs = { new TextFragment("Header content") }
};

// إضافة تذييل إلى الصفحات الجديدة
doc.Pages[1].Footer = new HeaderFooter()
{
    Margin = new MarginInfo(10, 10, 10, 10),
    Paragraphs = { new TextFragment("Footer content") }
};

س: هل يمكنني إدراج فواصل الصفحات في مواقع محددة بخلاف عدد معين من الصفوف؟

ج: نعم، يمكنك إدراج فواصل الصفحات في مواقع محددة بخلاف عدد معين من الصفوف. يمكنك ضبطIsInNewPage خاصية صف لtrue لإجبار الجدول على بدء صفحة جديدة بعد هذا الصف.

س: كيف يمكنني ضبط سلوك فاصل الصفحات بناءً على ارتفاع المحتوى؟

ج: يمكنك استخدامIsBroken خاصية الجدول لتمكين أو تعطيل فصل الصفوف التلقائي عبر الصفحات. عند التعيين علىtrue، فهو يسمح للصفوف بالتقاطع عبر الصفحات بناءً على ارتفاع المحتوى.