Работа с параграфи
Абзац е набор от знаци, комбинирани в логически блок и завършващи със специален знак – а paragraph break. В Aspose.Words един абзац е представен от класа Paragraph.
Вмъкване на абзац
За да вмъкнете нов абзац в документа, всъщност трябва да вмъкнете знак за прекъсване на абзац в него. DocumentBuilder.Writeln вмъква не само текстов низ в документа, но също така добавя нов абзац.
Текущото форматиране на шрифта също се определя от свойството Font, а текущото форматиране на абзаца се определя от свойството ParagraphFormat. В следващия раздел ще разгледаме по-подробно форматирането на абзаците.
Следващият пример за код показва как да вмъкнете абзац в документ:
Форматиране На Абзац
Текущото форматиране на абзац е представено от обект ParagraphFormat, който се връща от свойството ParagraphFormat. Този обект капсулира различни свойства за форматиране на абзац, Налични в Microsoft Word. Можете лесно да нулирате форматирането на абзаца по подразбиране до нормален стил, подравнен отляво без отстъп, без разредка, без граници и без засенчване, като извикате ClearFormatting.
Следващият пример за код показва как да зададете форматиране на абзац:
Прилагане На Стил На Абзац
Някои форматиращи обекти като шрифт или ParagraphFormat стилове на поддръжка. Един вграден или дефиниран от потребителя стил е представен от Style обект, който съдържа съответните свойства на стила, като име, основен стил, шрифт и форматиране на абзаци на стила и т.н.
Освен това обектът Style предоставя свойството StyleIdentifier, което връща идентификатор на стил, независим от локала, представен от стойността на Изброяване StyleIdentifier. Въпросът е, че имената на вградените стилове в Microsoft Word са локализирани за различни езици. С помощта на идентификатор на стил можете да намерите правилния стил, независимо от езика на документа. Стойностите на изброяване съответстват на Microsoft Word вградени стилове като Normal, Heading 1, Heading 2 и т.н. Всички дефинирани от потребителя стилове са присвоени StyleIdentifier.User стойност.
Следващият пример за код показва как да приложите стил на абзац:
Вмъкване на разделител на стилове, за да поставите различни стилове на абзаци
Разделителят за стил може да бъде добавен в края на абзац, като се използва клавишната комбинация MS Word. Тази функция позволява два различни стила на абзаца, използвани в един логически отпечатан абзац. Ако искате част от текста от началото на определено заглавие да се показва в съдържание, но не искате цялото заглавие в съдържанието, можете да използвате тази функция.
Следващият пример за код показва как да вмъкнете разделител за стил, за да настаните различни стилове на абзаци:
Идентифициране На Разделител За Стил На Абзац
Aspose.Words осигурява публична собственост BreakIsStyleSeparator в Paragraph клас позволява идентифицирането на разделител на стил, както е показано в примера, даден по-долу.:
Прилагане на граници и оцветяване към абзац
Границите в Aspose.Words са представени от клас BorderCollection - това е колекция от Border обекти, които са достъпни по Индекс или по тип на границата. Типът на границата е представен чрез изброяването BorderType. Някои стойности от изброяването са приложими за няколко или само за един елемент на документа. Например BorderType.Bottom е приложим за абзац или клетка от таблица, докато BorderType.DiagonalDown задава диагоналната граница само в клетка от таблица.
Както колекцията от граници, така и всяка отделна граница имат сходни атрибути като цвят, стил на линията, ширина на линията, разстояние от текста и незадължителна сянка. Те са представени от свойства със същото име. Можете да постигнете различни типове граници, като комбинирате стойностите на свойствата. Освен това обектите BorderCollection и Border ви позволяват да нулирате тези стойности по подразбиране, като извикате метода ClearFormatting.
Aspose.Words също има клас Shading съдържа атрибути за засенчване на елементите на документа. Можете да зададете желаната текстура за засенчване и цветовете, които се прилагат към фона и предния план на елемента.
Текстурата на засенчване е зададена със стойност TextureIndex изброяване, която позволява прилагането на различни модели към Shading обект. Например за да зададете цвят на фона за елемент на документа, използвайте стойността TextureIndex.TextureSolid и задайте цвета на оцветяване на преден план, както е подходящо.
Следният пример за код показва как да приложите граници и оцветяване към абзац: