کار با متن در جدول

همانطور که در مقاله های قبلی ذکر شد، یک جدول معمولا حاوی متن ساده است، اگرچه می توان محتوای دیگری مانند تصاویر یا حتی جداول دیگر را در سلول های جدول قرار داد.

افزودن متن یا محتوای دیگر به جدول با استفاده از روش های مناسب کلاس DocumentBuilder انجام می شود و در مقاله “ایجاد جدول” توضیح داده شده است. در این مقاله در مورد نحوه کار با متن در جدول موجود صحبت خواهیم کرد.

جایگزین کردن متن در جدول

جدول، مانند هر گره دیگری در Aspose.Words، به شی Range دسترسی دارد. با استفاده از شی محدوده جدول، می توانید متن را در جدول جایگزین کنید.

قابلیت استفاده از کاراکترهای خاص هنگام جایگزینی در حال حاضر پشتیبانی می شود، بنابراین می توان متن موجود را با متن چند پاراگراف جایگزین کرد. برای انجام این کار، باید از متاکاراکترهای ویژه ای که در روش Replace مربوطه توضیح داده شده است استفاده کنید.

به طور معمول، جایگزینی متن باید در سطح سلول (در هر سلول) یا در سطح پاراگراف انجام شود.

مثال کد زیر نشان می دهد که چگونه می توان تمام نمونه های یک رشته متن را در سلول های یک جدول کامل جایگزین کرد:

متن ساده را از جدول یا سلول استخراج کنید

با استفاده از شی Range، می‌توانید متدهایی را در کل محدوده جدول فراخوانی کنید و جدول را به صورت متن ساده استخراج کنید. برای این کار از ویژگی Text استفاده کنید

مثال کد زیر نحوه چاپ محدوده متن جدول را نشان می دهد:

از همین روش فقط برای استخراج محتوا از تک تک سلول های جدول استفاده می شود.

مثال کد زیر نحوه چاپ یک محدوده متنی از عناصر ردیف و جدول را نشان می دهد:

کار با متن جدول جایگزین

جداول Microsoft Word دارای یک table title و table description هستند که یک نمایش متنی جایگزین از اطلاعات موجود در جدول ارائه می کنند.

در Aspose.Words، می‌توانید عنوان و توضیحات جدول را با استفاده از ویژگی‌های Title و Description اضافه کنید. این ویژگی‌ها برای اسناد DOCX مطابق با ISO/IEC 29500 معنی‌دار هستند. هنگام ذخیره در قالب‌های زودتر از ISO/IEC 29500، این ویژگی‌ها نادیده گرفته می‌شوند.

مثال کد زیر نحوه تنظیم مشخصات عنوان و توضیحات یک جدول را نشان می دهد: