خلية جدول الأنماط

مقدمة

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

المتطلبات الأساسية

قبل الغوص في الكود، تأكد من أن لديك المتطلبات الأساسية التالية:

  1. Aspose.PDF لـ .NET: قم بتنزيل أحدث إصدار من Aspose.PDF وتثبيته منهنا.
  2. IDE (مثل Visual Studio): قم بإعداد بيئة تطوير .NET.
  3. المعرفة الأساسية لبرمجة C#: مطلوب القليل من الألفة مع C#.
  4. ترخيص Aspose.PDF: احصل على ترخيص مؤقت أو كامل لفتح الميزات الكاملة للمكتبة. يمكنك الحصول على نسخة تجريبية مجانيةهنا.

استيراد الحزم

قبل البدء، تأكد من استيراد مساحات الأسماء الضرورية. ستحتاج إلى ما يلي في مشروعك:

using Aspose.Pdf.LogicalStructure;
using Aspose.Pdf.Tagged;
using Aspose.Pdf.Text;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

الآن بعد أن تم إعداد كل شيء، دعنا ننتقل إلى الدليل خطوة بخطوة!

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

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

الخطوة الأولى هي إنشاء مستند PDF جديد. في Aspose.PDF، يمكنك تهيئة مستند PDF جديدDocument الكائن الذي يمثل ملف PDF الخاص بك.

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

// إنشاء مستند PDF جديد
Document document = new Document();
ITaggedContent taggedContent = document.TaggedContent;
taggedContent.SetTitle("Example table cell style");
taggedContent.SetLanguage("en-US");

هنا، نقوم بتهيئة مستند PDF وتعيين عنوانه ولغته. وهذا يمنح مستندك بنية مناسبة، وهو أمر ضروري للتوافق مع PDF/UA.

الخطوة 2: إعداد هيكل الجدول

يتم تعريف الجداول في ملفات PDF داخل عناصر البنية. دعنا ننشئ الجدول ونحدد صفوفه وأعمدته.

// الحصول على عنصر البنية الجذرية
StructureElement rootElement = taggedContent.RootElement;

// إنشاء عنصر هيكل الجدول
TableElement tableElement = taggedContent.CreateTableElement();
rootElement.AppendChild(tableElement);
TableTHeadElement tableTHeadElement = tableElement.CreateTHead();
TableTBodyElement tableTBodyElement = tableElement.CreateTBody();
TableTFootElement tableTFootElement = tableElement.CreateTFoot();

لقد قمنا الآن بتحديد رأس الجدول (TableTHeadElement)، جسم (TableTBodyElement)، والقدم (TableTFootElement) الأقسام. يمكنك أن تفكر فيها باعتبارها الهيكل العظمي لجدولك.

الخطوة 3: تصميم خلايا الرأس

يؤدي تصميم خلايا الرأس إلى إبرازها. هنا، نقوم بتطبيق ألوان الخلفية والحدود ومحاذاة النص.

int colCount = 4;
TableTRElement headTrElement = tableTHeadElement.CreateTR();
headTrElement.AlternativeText = "Head Row";

for (int colIndex = 0; colIndex < colCount; colIndex++)
{
    TableTHElement thElement = headTrElement.CreateTH();
    thElement.SetText($"Head {colIndex}");
    thElement.BackgroundColor = Color.GreenYellow;
    thElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
    thElement.IsNoBorder = true;
    thElement.Margin = new MarginInfo(16.0, 2.0, 8.0, 2.0);
    thElement.Alignment = HorizontalAlignment.Right;
}

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

الخطوة 4: ملء نص الجدول وتنسيقه

يحتوي نص الجدول على البيانات الفعلية. وفيما يلي كيفية تصميم كل خلية باستخدام هوامش وحدود وإعدادات نصية محددة.

int rowCount = 4;

for (int rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
    TableTRElement trElement = tableTBodyElement.CreateTR();
    trElement.AlternativeText = $"Row {rowIndex}";

    for (int colIndex = 0; colIndex < colCount; colIndex++)
    {
        TableTDElement tdElement = trElement.CreateTD();
        tdElement.SetText($"Cell [{rowIndex}, {colIndex}]");
        tdElement.BackgroundColor = Color.Yellow;
        tdElement.Border = new BorderInfo(BorderSide.All, 4.0F, Color.Gray);
        tdElement.Margin = new MarginInfo(8.0, 2.0, 8.0, 2.0);
        tdElement.Alignment = HorizontalAlignment.Center;
        
        TextState cellTextState = new TextState();
        cellTextState.ForegroundColor = Color.DarkBlue;
        cellTextState.FontSize = 7.5F;
        cellTextState.FontStyle = FontStyles.Bold;
        cellTextState.Font = FontRepository.FindFont("Arial");
        tdElement.DefaultCellTextState = cellTextState;
    }
}

في هذه الخطوة، نملأ نص الجدول بأربعة صفوف ونصمم كل خلية بخلفيات صفراء ونص أزرق غامق في المنتصف. نستخدم أيضًاMarginInfoفئة لتحديد الحشو حول النص.

الخطوة 5: تصميم التذييل

لإعطاء الجدول هيكلًا كاملاً، نضيف خلايا التذييل وننسقها، تمامًا كما فعلنا مع الرأس.

TableTRElement footTrElement = tableTFootElement.CreateTR();
footTrElement.AlternativeText = "Foot Row";

for (int colIndex = 0; colIndex < colCount; colIndex++)
{
    TableTDElement tdElement = footTrElement.CreateTD();
    tdElement.SetText($"Foot {colIndex}");
}

تم تصميم قسم التذييل بشكل مشابه لرأس الصفحة، مما يسهل على القراء متابعة بنية الجدول.

الخطوة 6: حفظ مستند PDF والتحقق منه

وأخيرًا، نحفظ مستند PDF ونتحقق مما إذا كان متوافقًا مع PDF/UA.

// احفظ مستند PDF المُوسوم
document.Save(dataDir + "StyleTableCell.pdf");

// التحقق من توافق PDF/UA
document = new Document(dataDir + "StyleTableCell.pdf");
bool isPdfUaCompliance = document.Validate(dataDir + "StyleTableCell.xml", PdfFormat.PDF_UA_1);
Console.WriteLine($"PDF/UA compliance: {isPdfUaCompliance}");

نقوم بحفظ ملف PDF واستخدامهValidate طريقة للتأكد من أنها تلبي معايير إمكانية الوصول (التوافق مع PDF/UA).

خاتمة

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

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

هل يمكنني تطبيق أنماط مختلفة على خلايا الجدول الفردية؟

نعم، يمكنك تصميم خلايا فردية عن طريق تخصيصTableTDElement ملكيات.

كيف يمكنني دمج خلايا الجدول؟

يمكنك استخدامColSpan وRowSpan خصائص لدمج الخلايا في جدول.

هل من الممكن إنشاء جدول متوافق مع PDF/UA؟

نعم، كما هو موضح في هذا الدليل، يمكنك ضمان توافق PDF/UA من خلال التحقق من صحة مستندك باستخدامValidate طريقة.

هل يمكنني استخدام خطوط مختلفة في خلايا الجدول؟

بالتأكيد! يمكنك تحديد خطوط مختلفة باستخدامTextState كائن لكل خلية.

كيف يمكنني تنزيل Aspose.PDF لـ .NET؟

يمكنك تنزيله منصفحة الإصدارات.

خصائص عناصر البنية في ملف PDF عنصر جدول الأنماط