Praca z paragrafami
Akapit jest zbiorem znaków połączonych w blok logiczny i kończących się znakiem specjalnym - a * przerwa paragrafu *. W Aspose.Words, ustęp jest reprezentowany przez Paragraph Klasa.
Dodanie paragrafu
Aby dodać nowy ustęp do dokumentu, należy dodać do niego znak łamania ustępu. DocumentBuilder.Writeln dodaje do dokumentu nie tylko ciąg tekstu, ale także dodaje przerwę w zdaniu.
Bieżące formatowanie czcionki jest również określone przez Font właściwość, a bieżące formatowanie paragrafu jest określone przez ParagraphFormat nieruchomości. W następnej części zajmiemy się bardziej szczegółowo formatowaniem paragrafów.
Poniższy przykład kodu pokazuje, jak umieścić ustęp w dokumencie:
Paragraf formatu
Obecne formatowanie paragrafu jest reprezentowane przez ParagraphFormat obiekt, który jest zwracany przez ParagraphFormat nieruchomości. Obiekt ten obejmuje różne właściwości formatowania fragmentów dostępne w Microsoft Word. Można łatwo zresetować formatowanie paragrafu do jego domyślnej - Normalny styl, wyrównany lewy, brak wcięć, brak odstępów, brak granic, brak cieniowania - przez wywołanie ClearFormatting.
Poniższy przykład kodu pokazuje jak ustawić formatowanie paragrafu:
Zastosuj styl paragrafu
Niektóre formatowanie obiektów takich jak Czcionka lub ParagraphFormat style wsparcia. Pojedynczy built- in lub user- defined style jest reprezentowany przez Style obiekt, który zawiera odpowiednie właściwości stylu, takie jak nazwa, styl bazowy, czcionka i formatowanie paragrafu stylu i tak dalej.
Ponadto Style obiekt zapewnia StyleIdentifier właściwość, która zwraca identyfikator typu niezależnego od lokalizacji reprezentowany przez StyleIdentifier wartość wyliczenia. Chodzi o to, że nazwy built- w stylach w Microsoft Word są zlokalizowane dla różnych języków. Używając identyfikatora stylu, można znaleźć odpowiedni styl niezależnie od języka dokumentu. Wartości wyliczenia odpowiadają Microsoft Word built- w stylach takich jak Normal, * Dział 1 *, * Dział 2 *, itd. Wszystkie style zdefiniowane przez użytkownika są przypisane do StyleIdentifier. Wartość użytkownika.
Poniższy przykład kodu pokazuje, jak stosować styl paragrafu:
Wstaw separator stylu, aby umieścić różne style paragrafów
Separator stylu można dodać do końca paragrafu używając Ctrl + Alt + Enter Skrót klawiatury do MS Word. Funkcja ta pozwala na dwa różne style paragrafów stosowane w jednym logicznym drukowanym akapicie. Jeśli chcesz, aby tekst od początku konkretnego nagłówka pojawił się w tabeli treści, ale nie chcesz całej pozycji w tabeli treści, możesz użyć tej funkcji.
Poniższy przykład kodu pokazuje, jak umieścić separator stylów, aby pomieścić różne style paragrafów:
Zastosuj granice i cieniowanie do paragrafu
Granice Aspose.Words są reprezentowane przez BorderCollection klasa - to jest kolekcja Border obiektów, które są dostępne według indeksu lub typu granicy. W Border typ jest reprezentowany przez BorderType wyliczenie. Niektóre wartości wyliczenia mają zastosowanie do kilku lub tylko jednego elementu dokumentu. Na przykład: BorderType.Bottom ma zastosowanie do celi paragrafu lub tabeli, podczas gdy BorderType.DiagonalDown określa przekątną granicy tylko w komórce tabeli.
Zarówno kolekcja granic jak i każda oddzielna granica mają podobne atrybuty jak kolor, styl linii, szerokość linii, odległość od tekstu i opcjonalny cień. Są one reprezentowane przez właściwości tej samej nazwy. Można osiągnąć różne typy granic łącząc wartości właściwości. Ponadto obie BorderCollection oraz Border obiekty pozwalają zresetować te wartości do wartości domyślnych przez wywołanie ClearFormatting Metoda.
Aspose.Words ma również Shading klasa zawiera atrybuty cieniowania elementów dokumentu. Można ustawić pożądaną teksturę cieniowania i kolory, które są stosowane do tła i pierwszoplanowej części.
Tektura cieniowania jest ustawiona z TextureIndex wartość wyliczenia, która pozwala na zastosowanie różnych wzorów do Shading obiekt. Na przykład, aby ustawić kolor tła dla elementu dokumentu, należy użyć TextureIndex.TextureSolid wartość i ustawić kolor cieniowania pierwszoplanowego odpowiednio. Przykład kodu podany poniżej pokazuje, jak stosować granice i zacienić do akapitu.
Poniższy przykład kodu pokazuje, jak stosować granice i zacienić do akapitu: