Praca z akapitami
Akapit to zestaw znaków połączonych w blok logiczny i kończących się znakiem specjalnym-a paragraph break. W Aspose.Words akapit jest reprezentowany przez klasę Paragraph.
Wstaw akapit
Aby wstawić nowy akapit do dokumentu, musisz wstawić do niego znak podziału akapitu. DocumentBuilder.Writeln wstawia do dokumentu nie tylko ciąg tekstu, ale także dodaje podział akapitu.
Bieżące formatowanie czcionki jest również określone przez właściwość Font, A bieżące formatowanie akapitu jest określone przez właściwość ParagraphFormat. W następnej sekcji omówimy bardziej szczegółowo formatowanie akapitów.
Poniższy przykład kodu pokazuje, jak wstawić akapit do dokumentu:
Formatuj Akapit
Bieżące formatowanie akapitu jest reprezentowane przez obiekt ParagraphFormat, który jest zwracany przez właściwość ParagraphFormat. Ten obiekt zawiera różne właściwości formatowania akapitów dostępne w Microsoft Word. Możesz łatwo zresetować formatowanie akapitu do domyślnego do normalnego stylu, wyrównane do lewej bez wcięć, bez odstępów, bez obramowań i bez cieniowania, wywołując ClearFormatting.
Poniższy przykład kodu pokazuje, jak ustawić formatowanie akapitu:
Zastosuj Styl Akapitu
Niektóre obiekty formatujące, takie jak czcionka lub ParagraphFormat, obsługują style. Pojedynczy styl wbudowany lub zdefiniowany przez użytkownika jest reprezentowany przez obiekt Style, który zawiera odpowiednie właściwości stylu, takie jak nazwa, styl podstawowy, formatowanie czcionki i akapitu stylu i tak dalej.
Ponadto obiekt Style udostępnia Właściwość StyleIdentifier, która zwraca niezależny od ustawień regionalnych identyfikator stylu reprezentowany przez wartość wyliczenia StyleIdentifier. Chodzi o to, że nazwy wbudowanych stylów w Microsoft Word są zlokalizowane dla różnych języków. Za pomocą identyfikatora stylu można znaleźć właściwy styl niezależnie od języka dokumentu. Wartości wyliczenia odpowiadają wbudowanym stylom Microsoft Word, takim jak Normal, Heading 1, Heading 2 itp. Wszystkie style zdefiniowane przez Użytkownika mają przypisaną wartość StyleIdentifier.User.
Poniższy przykład kodu pokazuje, jak zastosować styl akapitu:
Wstaw Separator stylów, aby umieścić różne style akapitów
Separator stylów można dodać na końcu akapitu za pomocą skrótu klawiaturowego Ctrl + Alt + Enter do MS Word. Ta funkcja pozwala na dwa różne style akapitów używane w jednym logicznym drukowanym akapicie. Jeśli chcesz, aby jakiś tekst z początku określonego nagłówka pojawił się w spisie treści, ale nie chcesz, aby cały nagłówek znajdował się w spisie treści, możesz użyć tej funkcji.
Poniższy przykład kodu pokazuje, jak wstawić separator stylów, aby uwzględnić różne style akapitów:
Zidentyfikuj Separator Stylu Akapitu
Aspose.Words zapewnia własność publiczną BreakIsStyleSeparator do klasy Paragraph umożliwia identyfikację akapitu separatora stylów, jak pokazano w poniższym przykładzie:
Zastosuj obramowania i cieniowanie do akapitu
Obramowania w Aspose.Words są reprezentowane przez klasę BorderCollection – jest to zbiór Border obiektów, do których dostęp uzyskuje się za pomocą indeksu lub typu obramowania. Typ obramowania jest reprezentowany przez wyliczenie BorderType. Niektóre wartości wyliczenia mają zastosowanie do kilku lub tylko jednego elementu dokumentu. Na przykład BorderType.Bottom ma zastosowanie do akapitu lub komórki tabeli, podczas gdy BorderType.DiagonalDown określa przekątną obramowanie tylko w komórce tabeli.
Zarówno kolekcja obramowań, jak i każda oddzielna ramka mają podobne atrybuty, takie jak kolor, styl linii, szerokość linii, odległość od tekstu i opcjonalny Cień. Są one reprezentowane przez właściwości o tej samej nazwie. Możesz osiągnąć różne typy obramowań, łącząc wartości właściwości. Ponadto zarówno obiekty BorderCollection, jak i Border umożliwiają zresetowanie tych wartości do wartości domyślnych poprzez wywołanie metody ClearFormatting.
Aspose.Words ma również Shading klasa zawiera atrybuty cieniowania dla elementów dokumentu. Możesz ustawić żądaną teksturę cieniowania i kolory, które są stosowane do tła i pierwszego planu elementu.
Tekstura cieniowania jest ustawiana za pomocą wartości wyliczenia TextureIndex, która umożliwia zastosowanie różnych wzorów do obiektu Shading. Na przykład, aby ustawić kolor tła dla elementu dokumentu, użyj wartości TextureIndex.TextureSolid i odpowiednio ustaw kolor CIENIOWANIA pierwszego planu.
Poniższy przykład kodu pokazuje, jak zastosować obramowanie i cieniowanie do akapitu: