Обединяване На Клетки В Таблица
Понякога определени редове в таблица изискват заглавие или големи блокове текст, които заемат пълната ширина на таблицата. За правилното проектиране на таблицата потребителят може да обедини няколко клетки в една. 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
за преобразуване на клетки. Този метод просто трансформира таблицата и добавя нови клетки, ако е необходимо.
Следващият пример за код показва горния метод в действие: