Praca z akapitami
Akapit to zbiór znaków połączonych w logiczny blok i zakończony znakiem specjalnym – podziałem akapitu. 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 również wstawia ciąg tekstowy do dokumentu, ale dodatkowo dodaje podział akapitu.
Bieżące formatowanie czcionki jest również określone przez właściwość font, a bieżące formatowanie akapitu jest określane przez właściwość paragraph_format.
Poniższy przykład kodu pokazuje, jak wstawić akapit do dokumentu:
Formatuj akapit
Bieżące formatowanie akapitu jest reprezentowane przez obiekt ParagraphFormat zwracany przez właściwość paragraph_format. Obiekt ten zawiera różne właściwości formatowania akapitów dostępne w formacie Microsoft Word. Możesz łatwo zresetować formatowanie akapitu do domyślnego stylu Normalnego, z wyrównaniem do lewej, bez wcięć, bez odstępów, bez obramowań i bez cieniowania, wywołując clear_formatting.
Poniższy przykład kodu pokazuje, jak ustawić formatowanie akapitu:
Zastosuj styl akapitowy
Niektóre obiekty formatujące, takie jak style Font lub ParagraphFormat, obsługują. 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, czcionka i formatowanie akapitu stylu itd.
Ponadto obiekt Style udostępnia właściwość Style.style_identifier, która zwraca niezależny od ustawień regionalnych identyfikator stylu reprezentowany przez wartość wyliczeniową StyleIdentifier. Chodzi o to, że nazwy wbudowanych stylów w Microsoft Word są zlokalizowane dla różnych języków. Używając identyfikatora stylu, możesz 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 itd. Wszystkim stylom zdefiniowanym przez użytkownika przypisana jest 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 stylu można dodać na końcu akapitu za pomocą skrótu klawiaturowego Ctrl + Alt + Enter w programie MS Word. Ta funkcja umożliwia użycie dwóch różnych stylów akapitu w jednym logicznie drukowanym akapicie. Jeśli chcesz, aby w spisie treści pojawił się tekst z początku określonego nagłówka, ale nie chcesz, aby cały nagłówek był w spisie treści, możesz skorzystać z 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 udostępnia publiczną właściwość break_is_style_separator w klasie Paragraph, która umożliwia identyfikację akapitu oddzielającego styl, jak pokazano w przykładzie podanym poniżej:
Zastosuj obramowanie i cieniowanie do akapitu
Granice są reprezentowane przez BorderCollection. Jest to zbiór obiektów Border, do których dostęp można uzyskać 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 ukośne 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. Łącząc wartości właściwości, można uzyskać różne typy obramowań. Ponadto zarówno obiekty BorderCollection, jak i Border umożliwiają przywrócenie tych wartości do wartości domyślnych poprzez wywołanie metody Border.clear_formatting.
Aspose.Words ma również klasę Shading zawierającą atrybuty cieniowania dla elementów dokumentu. Można ustawić żądaną teksturę cieniowania oraz kolory 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 wzorców do obiektu Shading. Na przykład, aby ustawić kolor tła elementu dokumentu, użyj wartości TextureIndex.TEXTURE_SOLID i ustaw odpowiednio kolor cieniowania pierwszego planu. Poniższy przykład pokazuje, jak zastosować obramowanie i cieniowanie do akapitu.
Poniższy przykład kodu pokazuje, jak zastosować obramowanie i cieniowanie do akapitu: