العمل مع الأعمدة والصفوف

لمزيد من التحكم في كيفية عمل الجداول، تعرف على كيفية معالجة الأعمدة والصفوف.

ابحث عن فهرس عنصر الجدول

تتم إدارة الأعمدة والصفوف والخلايا عن طريق الوصول إلى عقدة المستند المحددة بواسطة فهرسها. يتضمن العثور على فهرس أي عقدة جمع جميع العقد الفرعية لنوع العنصر من العقدة الأم، ثم استخدام طريقة IndexOf للعثور على فهرس العقدة المطلوبة في المجموعة.

ابحث عن فهرس جدول في مستند

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

يوضح مثال التعليمات البرمجية التالية كيفية استرداد فهرس جدول في مستند:

ابحث عن فهرس صف في جدول

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

يوضح مثال التعليمات البرمجية التالية كيفية استرداد فهرس صف في جدول:

ابحث عن فهرس خلية في صف

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

يوضح مثال التعليمات البرمجية التالية كيفية استرداد فهرس خلية في صف واحد:

العمل مع الأعمدة

في نموذج كائن المستند Aspose.Words (DOM)، تتكون العقدة Table من Row العقد ثم Cell العقد. وهكذا، في Document نموذج الكائن Aspose.Words، كما هو الحال في مستندات ورد، لا يوجد مفهوم للعمود.

حسب التصميم، تكون صفوف الجدول في Microsoft Word و Aspose.Words مستقلة تماما، ويتم تضمين الخصائص والعمليات الأساسية فقط في صفوف وخلايا الجدول. هذا يعطي الجداول القدرة على الحصول على بعض السمات المثيرة للاهتمام:

• يمكن أن يحتوي كل صف جدول على عدد مختلف تماما من الخلايا
• عموديا، يمكن أن يكون لخلايا كل صف عروض مختلفة
• من الممكن الانضمام إلى الجداول بتنسيقات صف مختلفة وعدد الخلايا

أي عمليات يتم إجراؤها على الأعمدة هي في الواقع “اختصارات” تؤدي العملية عن طريق تغيير خلايا الصف بشكل جماعي بطريقة تبدو وكأنها يتم تطبيقها على الأعمدة. بمعنى، يمكنك إجراء عمليات على الأعمدة ببساطة عن طريق التكرار على نفس فهرس خلية صف الجدول.

يبسط مثال التعليمات البرمجية التالي مثل هذه العمليات من خلال إثبات فئة واجهة تجمع الخلايا التي تشكل “عمود” من جدول:

يوضح مثال التعليمات البرمجية التالية كيفية إدراج عمود فارغ في جدول:

يوضح مثال التعليمات البرمجية التالية كيفية إزالة عمود من جدول في مستند:

حدد الصفوف كصفوف رأس

يمكنك اختيار تكرار الصف الأول في الجدول كصف رأس فقط في الصفحة الأولى أو في كل صفحة إذا تم تقسيم الجدول إلى عدة. في Aspose.Words، يمكنك تكرار صف الرأس في كل صفحة باستخدام خاصية HeadingFormat.

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

لاحظ أن صفوف الرأس لا تعمل في الجداول المتداخلة. بمعنى، إذا كان لديك جدول داخل جدول آخر، فلن يكون لهذا الإعداد أي تأثير. إنه قيد Microsoft Word لا يسمح بذلك، وليس Aspose.Words.

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

الحفاظ على الجداول والصفوف من كسر عبر الصفحات

هناك أوقات لا ينبغي فيها تقسيم محتويات الجدول عبر الصفحات. على سبيل المثال، إذا كان العنوان أعلى جدول، فيجب دائما الاحتفاظ بالعنوان والجدول معا في نفس الصفحة للحفاظ على المظهر المناسب.

هناك نوعان من التقنيات المنفصلة المفيدة لتحقيق هذه الوظيفة:

• Allow row break across pages، والتي يتم تطبيقها على صفوف الجدول
• Keep with next، والتي يتم تطبيقها على الفقرات في خلايا الجدول

بشكل افتراضي، يتم تعطيل الخصائص المذكورة أعلاه.

الحفاظ على صف من كسر عبر صفحات

يتضمن ذلك تقييد المحتوى داخل خلايا الصف من الانقسام عبر الصفحة. في Microsoft Word، يمكن العثور على هذا ضمن خصائص الجدول كخيار"السماح للصف بكسر الصفحات". في Aspose.Words تم العثور على هذا تحت RowFormat كائن من Row كخاصية RowFormat.AllowBreakAcrossPages.

يوضح مثال التعليمات البرمجية التالية كيفية تعطيل كسر الصفوف عبر الصفحات لكل صف في جدول:

الحفاظ على جدول من كسر عبر صفحات

لمنع الجدول من الانقسام عبر الصفحات، نحتاج إلى تحديد أننا نريد أن يظل المحتوى الموجود داخل الجدول معا.

للقيام بذلك، يستخدم Aspose.Words طريقة تسمح للمستخدمين بتحديد جدول وتمكين المعلمة KeepWithNext إلى صحيح لكل فقرة داخل خلايا الجدول. الاستثناء هو الفقرة الأخيرة في الجدول، والتي يجب تعيينها على خطأ.

يوضح مثال الكود التالي كيفية تعيين جدول للبقاء معا في نفس الصفحة: