Прилагане на форматиране на таблица

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

Aspose.Words осигурява богат API да изтеглите и приложите форматиране към таблица. Можеш да използваш Table, RowFormat, както и CellFormat Възел за форматиране.

В тази статия ще обсъдим как да използваме форматиране на различни възли на таблицата и какви настройки за форматиране на таблицата Aspose.Words Подпори.

Прилагане на форматиране към различни възли

В този раздел ще разгледаме прилагането на форматиране на различни възли на масата.

Форматиране на нивото на таблица

За да приложите форматиране към таблица, можете да използвате наличните свойства върху съответната Table Възел с помощта на Table, PreferredWidth, както и TableCollection Класове.

Имайте предвид, че таблицата трябва да има поне един ред, преди да могат да се прилагат свойствата на таблицата. Това означава, че при изграждане на маса с DocumentBuilder, това форматиране трябва да бъде направено след първото повикване InsertCell, или след като първият ред се добави към таблицата, или когато възлите се поставят директно в DOM.

Снимките по-долу показват представяне на Table форматиране на функции в Microsoft Word и съответните им свойства в Aspose.Words.

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

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

Форматиране на нивото на реда

Форматирането на ред ** може да се контролира с помощта на Row, RowFormat, както и RowCollection Класове.

Забележете, че a Row може да бъде само детски възел на Table. В същото време трябва да има поне един. Cell в Row така че форматирането може да се приложи към него.

Снимките по-долу показват представяне на Row форматиране на функции в Microsoft Word и съответните им свойства в Aspose.Words.

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

Форматиране на ниво на клетка

Форматирането на ниво клетки се контролира от Cell, CellFormat, както и CellCollection Класове.

Забележете, че a Cell може да бъде само детски възел на Row. В същото време трябва да има поне един. Paragraph в Cell така че форматирането може да се приложи към него.

В допълнение към Paragraph, Можете също така да поставите Table в Cell.

Снимките по-долу показват представяне на Cell форматиране на функции в Microsoft Word и съответните им свойства в Aspose.Words.

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

Следният пример за код показва как да зададете количеството пространство (в точки), за да добавите към лявото/горе/отдясно/отдолу на съдържанието на клетката:

Посочване на височините на реда

Най-простият начин да зададете височината на реда е да използвате DocumentBuilder. Използване на подходящата RowFormat свойства, можете да зададете настройка по подразбиране височина или да приложите различна височина за всеки ред в таблицата.

В Aspose.Words, височината на редовете в таблицата се контролира от:

• височината на греблото Height
• правилото за височината на имота за даден ред HeightRule

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

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

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

Посочете ширината на таблицата и клетките

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

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

• Предпочитана ширина на масата
• Предпочитана ширина на отделните клетки
• Позволява автоматизация на масата

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

В повечето случаи предпочитаната клетка се препоръчва в сравнение с широчината на таблицата. Предпочитаната широчина на клетката е повече в съответствие със спецификацията на формат DOX, както и Aspose.Words Модел.

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

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

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

Как да използвате Предпочитаната ширина

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

Подходящият предпочитан тип и стойност на ширината се определят посредством методите на PreferredWidth клас:

• на Auto поле за уточняване на авто или горно предпочитана ширина
• на FromPercent метод за определяне на ширината на процентите
• на FromPoints метод за определяне на широчината в точки

Снимките по-долу показват представяне на * предпочитаните характеристики на ширината* в Microsoft Word и съответните им свойства в Aspose.Words.

Пример за това как тези опции се прилагат към реална таблица в документ може да се види на снимката по-долу.

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

Посочете предпочитаната таблица или широчина на клетката

В Aspose.Words, Таблицата и широчината на клетките са определени, като се използва Table.PreferredWidth собственост и CellFormat.PreferredWidth имот, с опции, налични в PreferredWidthType Изброяване:

• Auto, която е еквивалентна на непредпочитана широчина
• Percent, който съответства на елемента спрямо наличното пространство в прозореца или размера на контейнера и преизчислява стойността, когато наличната ширина се променя
• Points, която съответства на елемент от посочената широчина в точки

По подразбиране една таблица може да бъде описана като монтирана на 100% от наличното пространство на страницата. В този случай, това означава, че масата ще се опита да заеме пространството между левите и десните страници.

Използване на Table.PreferredWidth имотът ще коригира предпочитаната си ширина спрямо неговия контейнер: страница, текстова колона или външна таблица, ако тя е гнездо.

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

Използване на CellFormat.PreferredWidth Имотът върху дадена клетка ще коригира предпочитаната ширина.

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

Намерете Предпочитан тип ширина и стойност

Можеш да използваш Type както и Value свойства, за да намерите предпочитаната ширина детайли на желаната таблица или клетка.

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

Как да зададете автоматично

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

Освен това, AllowAutoFit свойството може да се използва заедно с предпочитана широчина на клетката, за да се форматира клетка, която автоматично отговаря на съдържанието му, но също така има първоначална ширина. Ако е необходимо, широчината на клетката може да премине през тази ширина.

По подразбиране, Aspose.Words вмъква нова таблица, като използва Автоматично свързване към прозорец. Таблицата ще бъде обозначена според ширината на страницата. За промяна на масата, можете да се обадите на AutoFit метод. Този метод приема AutoFitBehavior изброяване, в което се посочва какъв тип автофит се прилага към таблицата.

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

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

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

Автофит таблица до прозорец

Когато автоматичното монтиране към прозорец се прилага към таблица, зад кулисите се извършват следните операции:

1. На Table.AllowAutoFit свойството е активирано за автоматично преоразмеряване на колоните, за да се побере на наличното съдържание, като се използва Table.PreferredWidth стойност от 100%
2. CellFormat.PreferredWidth се отстранява от всички клетки на таблицата
   Имайте предвид, че това е малко по-различно от Microsoft Word поведение, при което предпочитаната ширина на всяка клетка е определена на подходящи стойности въз основа на сегашния им размер и съдържание. Aspose.Words не актуализира предпочитаната ширина, така че те просто се изчистват вместо това.
3. Ширините на колоните са преброени за текущото съдържание на таблицата. Крайният резултат е таблица, която заема цялата налична ширина
4. Ширината на колоните в таблицата се променя автоматично, когато потребителят редактира текста

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

Пример за това как тези опции се прилагат към горната таблица може да се види на снимката по-долу.

AutoFit Таблица за съдържание

Когато масата е автоматизирана, съдържанието се извършва зад кулисите:

1. На Table.AllowAutoFit може автоматично да преоразмери всяка клетка според съдържанието й

2. Предпочитаната широчина на таблицата се отстранява от Table.PreferredWidth, CellFormat.PreferredWidth се отстранява за всяка таблица

   Имайте предвид, че тази опция автоматично премахва предпочитаната ширина от клетките, точно като в Microsoft Word. Ако искате да запазите размера на колоната и увеличаване или намаляване на колоните, за да се побере съдържанието, трябва да зададете Table.AllowAutoFit собственост на True самостоятелно, вместо да използва автофит прекия път.

3. weather forecast

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

Пример за това как тези опции се прилагат към горната таблица може да се види на снимката по-долу.

Изключване на автофита в таблица и използване на фиксирани колони

Ако вместо това таблица е с деактивиран автофит и се използват фиксирани ширини на колоните, се извършват следните стъпки:

1. Table.AllowAutoFit собственост е деактивирана, така че колоните не растат или свиват до тяхното съдържание
2. Предпочитаната широчина на цялата таблица се отстранява от Table.PreferredWidth, CellFormat.PreferredWidth се отстранява от всички клетки на таблицата
3. Крайният резултат е таблица, чиято ширина на колоната се определя от CellFormat.Width собственост, и чиито колони не са автоматично преоразмерени, когато потребителят влезе текст или когато страницата е преоразмерена

Имайте предвид, че ако не е посочена широчина за CellFormat.Width, се използва стойността по подразбиране на един инч (72 точки).

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

Пример за това как тези опции се прилагат към горната таблица може да се види на снимката по-долу.

Ред на точност при изчисляване на широчината на клетките

Aspose.Words позволява на потребителите да определят ширината на таблица или клетка чрез множество обекти, включително CellFormat го Width Имотът е предимно оставен от предишни версии, обаче, той все още е полезен за опростяване на определянето на ширината на клетката.

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

Aspose.Words използва следния ред за изчисляване на широчината на клетките:

Ред	Имоти	Описание
1	AllowAutoFit се определя	Ако AutoFit е включена: - масата може да се разрастне покрай предпочитаната ширина, за да се настанят в съдържанието. - промяна в CellFormat.Width стойност се игнорира и клетката ще се побере в съдържанието си вместо
2	PreferredWidthType със стойност Points или Percent	CellFormat.Width е игнориран
3	PreferredWidthType със стойност Auto	Стойността от CellFormat.Width се копира и става предпочитаната ширина на клетката (в точки)

Всички промени в собствеността на широчината не се актуализират в предпочитаната ширина и вместо това трябва да се прилагат спрямо предпочитаната широчина.

При създаването на фиксирана подредба на таблицата, посочете ширината на клетката. Клетка без ширина не може да бъде записана във формат DOC. Формати на документи, различни от DOC, като например DOCX, позволяват по принцип да се съхранят клетки без широчина в фиксиран макет на таблицата.

Разрешаване на разделяне между клетките

Можете да получите или да зададете допълнително пространство между клетките на таблицата, подобно на опцията “Продавай разстоянието” в Microsoft Word. Това може да се направи с помощта на AllowCellSpacing собственост.

Пример за това как тези опции се прилагат към реална таблица в документ може да се види на снимката по-долу.

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

Прилагане на граници и оформяне

Границите и засенчването могат да се прилагат към цялата таблица, като се използва Table.SetBorder, Table.SetBorders както и Table.SetShading, или само до специфични клетки, използващи CellFormat.Borders както и CellFormat.Shading. Освен това могат да се настроят греди RowFormat.Borders, Но по този начин не може да се приложи сянка.

Снимките по-долу показват границите и настройките на сянката в Microsoft Word и съответните им свойства в Aspose.Words.

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