العمل مع الأعمدة والصفوف
لمزيد من التحكم في كيفية عمل الجداول، تعرف على كيفية التعامل مع الأعمدة والصفوف.
ابحث عن فهرس عناصر الجدول
تتم إدارة الأعمدة والصفوف والخلايا عن طريق الوصول إلى عقدة المستند المحددة من خلال فهرسها. يتضمن العثور على فهرس أي عقدة جمع كل العقد الفرعية لنوع العنصر من العقدة الأصلية، ثم استخدام طريقة IndexOf للعثور على فهرس العقدة المطلوبة في المجموعة.
ابحث عن فهرس الجدول في مستند
في بعض الأحيان قد تحتاج إلى إجراء تغييرات على جدول معين في المستند. للقيام بذلك، يمكنك الرجوع إلى الجدول حسب فهرسه.
يوضح مثال التعليمات البرمجية التالي كيفية استرداد فهرس جدول في مستند:
ابحث عن فهرس الصف في جدول
وبالمثل، قد تحتاج إلى إجراء تغييرات على صف معين في جدول محدد. للقيام بذلك، يمكنك أيضًا الإشارة إلى صف حسب فهرسه.
يوضح مثال التعليمات البرمجية التالي كيفية استرداد فهرس صف في جدول:
ابحث عن فهرس الخلية في صف
أخيرًا، قد تحتاج إلى إجراء تغييرات على خلية معينة، ويمكنك القيام بذلك عن طريق فهرس الخلايا أيضًا.
يوضح مثال التعليمات البرمجية التالي كيفية استرداد فهرس خلية في صف واحد:
العمل مع الأعمدة
في Aspose.Words Document Object Model (DOM)، تتكون عقدة Table من عقد Row ثم عقد Cell. وبالتالي، في نموذج كائن Document الخاص بـ Aspose.Words، كما هو الحال في مستندات Word، لا يوجد مفهوم للعمود.
حسب التصميم، تكون صفوف الجدول في Microsoft Word وAspose.Words مستقلة تمامًا، ويتم تضمين الخصائص والعمليات الأساسية فقط في صفوف وخلايا الجدول. وهذا يمنح الجداول القدرة على الحصول على بعض السمات المثيرة للاهتمام:
- يمكن أن يحتوي كل صف في الجدول على عدد مختلف تمامًا من الخلايا
- عموديًا، يمكن أن يكون لخلايا كل صف عرض مختلف
- من الممكن ضم الجداول بتنسيقات صفوف مختلفة وعدد الخلايا
أي عمليات يتم إجراؤها على الأعمدة هي في الواقع “اختصارات” تنفذ العملية عن طريق تغيير خلايا الصفوف بشكل جماعي بطريقة تبدو وكأنها مطبقة على الأعمدة. أي أنه يمكنك تنفيذ العمليات على الأعمدة ببساطة عن طريق التكرار على نفس فهرس خلايا صف الجدول.
يبسط مثال التعليمات البرمجية التالي مثل هذه العمليات عن طريق إثبات فئة الواجهة التي تجمع الخلايا التي تشكل “عمودًا” في الجدول:
يوضح مثال التعليمات البرمجية التالي كيفية إدراج عمود فارغ في جدول:
يوضح مثال التعليمات البرمجية التالي كيفية إزالة عمود من جدول في مستند:
تحديد الصفوف كصفوف رأس
يمكنك اختيار تكرار الصف الأول في الجدول كصف الرأس فقط في الصفحة الأولى أو في كل صفحة إذا تم تقسيم الجدول إلى عدة صفحات. في Aspose.Words، يمكنك تكرار صف الرأس في كل صفحة باستخدام خاصية HeadingFormat.
يمكنك أيضًا وضع علامة على صفوف رؤوس متعددة إذا كانت هذه الصفوف موجودة واحدة تلو الأخرى في بداية الجدول. للقيام بذلك، تحتاج إلى تطبيق خصائص HeadingFormat على هذه الصفوف.
يوضح مثال التعليمات البرمجية التالي كيفية إنشاء جدول يتضمن صفوف الرؤوس التي تتكرر في الصفحات اللاحقة:
منع الجداول والصفوف من الاختراق عبر صفحات
هناك أوقات لا ينبغي فيها تقسيم محتويات الجدول عبر الصفحات. على سبيل المثال، إذا كان العنوان أعلى الجدول، فيجب دائمًا الاحتفاظ بالعنوان والجدول معًا في نفس الصفحة للحفاظ على المظهر المناسب.
هناك طريقتان منفصلتان مفيدتان لتحقيق هذه الوظيفة:
Allow row break across pages، والذي يتم تطبيقه على صفوف الجدولKeep with next، والذي يتم تطبيقه على الفقرات في خلايا الجدول
بشكل افتراضي، يتم تعطيل الخصائص المذكورة أعلاه.
منع الصف من الاختراق عبر صفحات
يتضمن ذلك تقييد المحتوى الموجود داخل خلايا الصف من الانقسام عبر الصفحة. في Microsoft Word، يمكن العثور على هذا ضمن خصائص الجدول كخيار “السماح للصف بالتقاطع بين الصفحات”. في Aspose.Words، تم العثور على هذا ضمن كائن RowFormat الخاص بـ Row كخاصية RowFormat.AllowBreakAcrossPages.
يوضح مثال التعليمات البرمجية التالي كيفية تعطيل تقسيم الصفوف عبر الصفحات لكل صف في الجدول:
منع الجدول من الاختراق عبر صفحات
لمنع تقسيم الجدول عبر الصفحات، نحتاج إلى تحديد أننا نريد أن يظل المحتوى الموجود داخل الجدول معًا.
للقيام بذلك، يستخدم Aspose.Words طريقة تسمح للمستخدمين بتحديد جدول وتمكين معلمة KeepWithNext إلى true لكل فقرة داخل خلايا الجدول. الاستثناء هو الفقرة الأخيرة في الجدول، والتي يجب تعيينها على false.
يوضح مثال التعليمات البرمجية التالي كيفية تعيين جدول ليبقى معًا في نفس الصفحة: