Обединяване На Клетки В Таблица

Понякога определени редове в таблица изискват заглавие или големи блокове текст, които заемат пълната ширина на таблицата. За правилното проектиране на таблицата потребителят може да обедини няколко клетки в една. Aspose.Words поддържа обединени клетки при работа с всички входни формати, включително импортиране на HTML съдържание.

Как да обедините клетките на таблицата

В Aspose.Words слетите клетки са представени от следните свойства на класа CellFormat:

  • HorizontalMerge който описва дали клетката е част от хоризонтално сливане на клетки
  • VerticalMerge който описва дали клетката е част от вертикално сливане на клетки

Стойностите на тези свойства определят поведението на сливане на клетки:

  • Първата клетка в поредица от Обединени клетки ще има CellMerge.First
  • Всички впоследствие обединени клетки ще имат CellMerge.Previous
  • Клетка, която не е обединена, ще има CellMerge.None

Проверете дали клетката е обединена

За да проверите дали дадена клетка е част от поредица от Обединени клетки, просто проверяваме свойствата HorizontalMerge и VerticalMerge.

Следващият пример за код показва как да отпечатате хоризонталния и вертикалния тип обединяване на клетки:

Обединени клетки в Таблица

За да обедините клетки в таблица, създадена с DocumentBuilder, трябва да зададете подходящия тип обединяване за всяка клетка, където се очаква сливането – първо CellMerge.First и след това CellMerge.Previous.

Също така трябва да запомните да изчистите настройката за обединяване за тези клетки, където не се изисква сливане – това може да стане чрез задаване на първата клетка без сливане на CellMerge.None. Ако това не стане, всички клетки в таблицата ще бъдат обединени.

Следващият пример за код показва как да създадете таблица с два реда, където клетките в първия ред се обединяват хоризонтално:

Следващият пример за код показва как да създадете таблица с две колони, където клетките в първата колона са вертикално обединени:

Обединяване на клетки в таблица в други случаи

В други ситуации, когато DocumentBuilder не се използва, например в съществуваща таблица, сливането на клетки по предишния начин може да не е толкова лесно. Вместо това можем да обвием основните операции, участващи в прилагането на свойства за обединяване към клетки, в метод, който прави задачата много по-лесна. Този метод е подобен на метода за автоматизация на обединяването, който се нарича обединяване на диапазон от клетки в таблица.

Кодът по-долу ще Обедини клетките на таблицата в определения диапазон, започвайки от дадената клетка и завършвайки в крайната клетка. В този случай диапазонът може да обхваща няколко реда или колони:

Следващият пример за код показва как да обедините диапазон от клетки между две определени клетки:

В зависимост от версията на рамката, която използвате, може да искате да прецизирате този метод, като го превърнете в метод за разширение. В този случай можете да извикате този метод директно в клетка, за да обедините диапазон от клетки, като cell1.Merge(cell2).

Вертикални и хоризонтални обединени клетки в Таблица

Както казахме в предишни статии, Таблица Microsoft Word е набор от независими редове. Всеки ред има набор от клетки, които са независими от клетките на други редове. Така в таблицата Microsoft Word няма такъв обект като" колона", а" 1-ва колона “е нещо като"множеството от 1-ва клетки на всеки ред в таблицата”. Това позволява на потребителите да имат таблица, в която например 1 – ви ред се състои от две клетки – 2 см и 1 см, а 2-ри ред се състои от две различни клетки-1 см и 2 см ширина. И Aspose.Words поддържа тази концепция за таблици.

Таблица HTML има по същество различна структура: всеки ред има същия брой клетки и (това е важно за задачата) всяка клетка има ширината на съответната колона, еднаква за всички клетки в една колона. Така че, ако HorizontalMerge и VerticalMerge върнете неправилна стойност, използвайте следния пример за код:

Конвертиране в хоризонтално обединени клетки

Понякога не е възможно да се открие кои клетки се обединяват, защото някои по-нови версии на Microsoft Word вече не използват флаговете за обединяване, когато клетките се обединяват хоризонтално. Но за ситуации, при които клетките се обединяват в клетка хоризонтално по тяхната ширина, като се използват знамена за обединяване, Aspose.Words предоставя метода ConvertToHorizontallyMergedCells за преобразуване на клетки. Този метод просто трансформира таблицата и добавя нови клетки, ако е необходимо.

Следващият пример за код показва горния метод в действие: