العمل مع النص في الجدول

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

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

استبدال النص في جدول

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

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

عادةً، يجب أن يتم استبدال النص على مستوى الخلية (لكل خلية) أو على مستوى الفقرة.

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

استخراج نص عادي من الجدول أو الخلية

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

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

يتم استخدام نفس الأسلوب لاستخراج المحتوى من خلايا الجدول الفردية فقط.

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

العمل مع نص الجدول البديل

تحتوي جداول Microsoft Word على table title وtable description التي توفر تمثيلاً نصيًا بديلاً للمعلومات الموجودة في الجدول.

في Aspose.Words، يمكنك أيضًا إضافة عنوان جدول ووصفه باستخدام خصائص Title وDescription. تعتبر هذه الخصائص ذات معنى بالنسبة لمستندات DOCX المتوافقة مع ISO/IEC 29500. عند الحفظ بتنسيقات أقدم من ISO/IEC 29500، يتم تجاهل هذه الخصائص.

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