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 wstawia do dokumentu nie tylko ciąg tekstowy, 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ślane przez właściwość ParagraphFormat. W następnej sekcji omówimy bardziej szczegółowo formatowanie akapitu.
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ść ParagraphFormat. Obiekt ten zawiera różne właściwości formatowania akapitów dostępne w formacie Microsoft Word. Możesz łatwo przywrócić domyślne formatowanie akapitu – styl normalny, wyrównanie 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 Font lub ParagraphFormat, obsługują style. Jeden 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, formatowanie 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. Faktem jest, ż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, Nagłówek 1, Nagłówek 2 i tak dalej. Wszystkie style zdefiniowane przez użytkownika mają ustawioną wartość wyliczenia 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 formacie Microsoft Word. Ta funkcja umożliwia użycie dwóch różnych stylów akapitu w tym samym logicznie drukowanym akapicie. Jeśli chcesz, aby w spisie treści pojawił się tekst z początku danego nagłówka, ale nie chcesz, aby w spisie treści był pokazywany cały nagłówek, 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ść BreakIsStyleSeparator klasy Paragraph w celu identyfikacji akapitu za pomocą separatora stylu, jak pokazano w poniższym przykładzie:
Zastosuj obramowanie i cieniowanie do akapitu
Granice w Aspose.Words są reprezentowane przez klasę BorderCollection – jest to zbiór obiektów Border, do których dostęp można uzyskać poprzez indeks lub typ obramowania. Typ obramowania jest z kolei reprezentowany przez wyliczenie BorderType. Niektóre wartości wyliczenia dotyczą wielu lub tylko jednego elementu dokumentu. Na przykład BorderType.Bottom dotyczy 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ń. Dodatkowo obiekty BorderCollection i Border umożliwiają przywrócenie tych wartości do wartości domyślnych poprzez wywołanie metody ClearFormatting.
Aspose.Words ma również klasę Shading, która zawiera atrybuty cieniowania dla elementów dokumentu. Można ustawić żądaną teksturę cieniowania i kolory stosowane do tła i pierwszego planu elementu, korzystając z wartości wyliczenia TextureIndex. TextureIndex umożliwia także zastosowanie różnych wzorców do obiektu Shading. Na przykład, aby ustawić kolor tła elementu dokumentu, użyj wartości TextureIndex.TextureSolid i ustaw odpowiedni kolor cieniowania pierwszego planu.
Poniższy przykład kodu pokazuje, jak zastosować obramowanie i cieniowanie do akapitu:
Policz wiersze akapitu
Jeśli chcesz policzyć liczbę wierszy w akapicie dowolnego dokumentu programu Word, można użyć następującego przykładowego kodu: