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

За повече контрол върху това как работят таблиците, научете се как да манипулирате колони и редове.

Търсене на индекс на елемента на таблица

Колони, редове и клетки се управляват чрез достъп до избрания документен възел чрез неговия индекс. Намирането на индекс на всеки възел включва събиране на всички детски възли от типа елемент от базовия възел, и след това използване на IndexOf метод за намиране на индекса на желания възел в колекцията.

Намерете индекса на таблица в документ

Понякога може да се наложи да направите промени в определена таблица в документ. За да направите това, можете да се позовавате на таблица по нейния индекс.

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

Намерете индекс на ред в таблица

По същия начин, може да се наложи да направите промени в определен ред в избрана таблица. За да направите това, можете да се обърнете към ред по неговия индекс.

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

Намерете индекс на клетка в ред

И накрая, може да се наложи да се направят промени в определена клетка и можете да направите това по клетъчен индекс, както добре.

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

Работа с колони

В Aspose.Words Document Object Model (DOM), Table Възелът се състои от Row Възли и после Cell Възли. По този начин в Document Модел на обекта Aspose.Words, както в Word документи, няма понятие за колона.

По дизайн, редовете в таблицата Microsoft Word както и Aspose.Words са напълно независими и основните свойства и операции се съдържат само в редовете и клетките на таблицата. Това дава на таблиците способността да имат някои интересни атрибути:

  • Всеки ред на масата може да има напълно различен брой клетки
  • Вертикално, клетките на всеки ред могат да имат различни ширини
  • Възможно е да се присъединят таблици с различен ред формати и брой клетки

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

Следният пример за код опростява такива операции чрез доказване на фасаден клас, който събира клетките, които съставляват “колони” на таблица:

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

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

Задаване на редове като заглавни редове

Можете да изберете да повторите първия ред в таблицата като Header Row само на първата страница или на всяка страница, ако таблицата е разделена на няколко. В Aspose.Words, Можете да повторите заглавието на всяка страница с помощта на HeadingFormat собственост.

Можете също така да маркирате няколко заглавни редове, ако тези редове са разположени един след друг в началото на таблицата. За да направите това, трябва да приложите HeadingFormat свойства на тези редове.

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

Запазване на таблици и редове от прекъсване на страниците

Има моменти, когато съдържанието на таблицата не трябва да се разделя на страници. Например, ако заглавието е над една маса, заглавието и таблицата трябва винаги да се държат заедно на една и съща страница, за да се запази правилното външен вид.

Има две отделни техники, които са полезни за постигане на тази функционалност:

  • Allow row break across pages, за редове в таблицата
  • Keep with next, които се прилагат към параграфи в таблици

По подразбиране горните свойства са изключени.

Запазване на ред от прекъсване на страниците

Това включва ограничаване на съдържанието в клетките на един ред от разделяне на една страница. В Microsoft Word, това може да се намери под Table Properties като опцията готварски ред да се прекъсне през страниците. В Aspose.Words това е открито под RowFormat обект на a Row като свойство RowFormat.AllowBreakAcrossPages.

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

Запазване на таблица от прекъсване на страниците

За да спрем разделянето на таблицата между страниците, трябва да уточним, че искаме съдържанието в таблицата да остане заедно.

За да направите това, Aspose.Words използва метод, който позволява на потребителите да избират таблица и позволява KeepWithNext параметър към true за всеки параграф в рамките на таблиците. Изключението е последният параграф от таблицата, който следва да бъде определен false.

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