ادغام سلول های جدول

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

نحوه ادغام سلول های جدول

در Aspose.Words، سلول های ادغام شده با ویژگی های زیر از کلاس CellFormat نشان داده می شوند:

  • HorizontalMerge که توضیح می دهد که آیا سلول بخشی از ادغام افقی سلول ها است یا خیر
  • VerticalMerge که توضیح می دهد که آیا سلول بخشی از ادغام عمودی سلول ها است

مقادیر این ویژگی ها رفتار ادغام سلول ها را تعیین می کند:

  • اولین سلول در دنباله ای از سلول های ادغام شده دارای CellMerge.First خواهد بود
  • هر سلول ادغام شده بعدی دارای CellMerge.Previous خواهد بود
  • سلولی که ادغام نشده باشد دارای CellMerge.None خواهد بود

بررسی کنید که سلول ادغام شده است یا خیر

برای بررسی اینکه آیا یک سلول بخشی از دنباله ای از سلول های ادغام شده است، ما به سادگی ویژگی های HorizontalMerge و VerticalMerge را بررسی می کنیم.

مثال کد زیر نحوه چاپ نوع ادغام سلول های افقی و عمودی را نشان می دهد:

ادغام سلول های جدول هنگام استفاده از DocumentBuilder

برای ادغام سلول‌ها در جدولی که با DocumentBuilder ایجاد شده است، باید نوع ادغام مناسب را برای هر سلولی که انتظار ادغام وجود دارد تنظیم کنید - ابتدا CellMerge.First و سپس CellMerge.Previous.

همچنین، باید به خاطر داشته باشید که تنظیمات ادغام را برای آن دسته از سلول‌هایی که نیازی به ادغام ندارند پاک کنید - این کار را می‌توان با تنظیم اولین سلول غیرادغام‌شده روی CellMerge.None انجام داد. اگر این کار انجام نشود، تمام سلول های جدول ادغام می شوند.

مثال کد زیر نحوه ایجاد یک جدول با دو ردیف را نشان می دهد که در آن سلول های ردیف اول به صورت افقی ادغام می شوند:

مثال کد زیر نحوه ایجاد یک جدول دو ستونی را نشان می دهد که در آن سلول های ستون اول به صورت عمودی ادغام می شوند:

ادغام سلول های جدول در موارد دیگر

در موقعیت‌های دیگری که از DocumentBuilder استفاده نمی‌شود، مانند جدول موجود، ادغام سلول‌ها به روش قبلی ممکن است به آسانی نباشد. درعوض، می‌توانیم عملیات اساسی مربوط به اعمال ویژگی‌های ادغام در سلول‌ها را به روشی بپیچیم که کار را بسیار آسان‌تر کند. این روش شبیه به روش اتوماسیون Merge است که برای ادغام محدوده ای از سلول ها در یک جدول نامیده می شود.

کد زیر سلول های جدول را در محدوده مشخص شده ادغام می کند که از سلول داده شده شروع می شود و به سلول انتهایی ختم می شود. در این مورد، محدوده می تواند چندین ردیف یا ستون را در بر بگیرد:

مثال کد زیر نحوه ادغام محدوده ای از سلول ها را بین دو سلول مشخص نشان می دهد:

بسته به نسخه‌ای از .NET Framework که استفاده می‌کنید، ممکن است بخواهید این روش را با تبدیل آن به یک روش افزودنی اصلاح کنید. در این حالت، می توانید این روش را مستقیماً روی یک سلول فراخوانی کنید تا محدوده ای از سلول ها مانند cell1.Merge(cell2) را ادغام کنید.

سلول های ادغام شده عمودی و افقی در جدول HTML

همانطور که در مقالات قبلی گفتیم، جدول در Microsoft Word مجموعه ای از ردیف های مستقل است. هر ردیف دارای مجموعه ای از سلول ها است که مستقل از سلول های ردیف های دیگر هستند. بنابراین، در جدول Microsoft Word هیچ شیئی به عنوان “ستون” وجود ندارد و “ستون اول” چیزی شبیه به “مجموعه سلول های اول هر ردیف در جدول” است. این به کاربران امکان می‌دهد جدولی داشته باشند که در آن، برای مثال، ردیف اول از دو خانه 2 سانتی‌متر و 1 سانتی‌متری تشکیل شده است، و ردیف دوم از دو سلول مختلف - به عرض 1 سانتی‌متر و 2 سانتی‌متر تشکیل شده است. و Aspose.Words از این مفهوم جداول پشتیبانی می کند.

یک جدول در HTML اساساً ساختار متفاوتی دارد: هر ردیف دارای تعداد سلول های یکسانی است و (برای کار مهم است) هر سلول دارای عرض ستون مربوطه است، برای همه سلول های یک ستون یکسان است. بنابراین اگر HorizontalMerge و VerticalMerge مقدار نادرستی برمی‌گردانند، از مثال کد زیر استفاده کنید:

تبدیل به سلول های ادغام شده افقی

گاهی اوقات نمی‌توان تشخیص داد کدام سلول‌ها ادغام شده‌اند، زیرا برخی از نسخه‌های جدیدتر Microsoft Word وقتی سلول‌ها به صورت افقی ادغام می‌شوند، دیگر از پرچم‌های ادغام استفاده نمی‌کنند. اما برای موقعیت‌هایی که سلول‌ها با استفاده از پرچم‌های ادغام به صورت افقی در یک سلول ادغام می‌شوند، Aspose.Words روش ConvertToHorizontallyMergedCells را برای تبدیل سلول‌ها ارائه می‌کند. این روش به سادگی جدول را تبدیل می کند و سلول های جدید را در صورت نیاز اضافه می کند.

مثال کد زیر روش فوق را در عمل نشان می دهد:

با ستون ها و ردیف ها در C# کار کنید موقعیت جدول در C#