Przegląd narzędzia do tworzenia dokumentów

DocumentBuilder to potężna klasa, która kojarzy się z Document i umożliwia budowanie dynamicznych dokumentów od podstaw lub dodawanie nowych elementów do już istniejącego.

DocumentBuilder udostępnia metody wstawiania tekstu, pól wyboru, obiektów ole, akapitów, list, tabel, obrazów i innych elementów treści. Umożliwia określenie czcionek, formatowanie akapitu lub sekcji oraz wykonywanie innych operacji.

Konstruktor dokumentów lub Aspose.Words DOM

DocumentBuilder uzupełnia klasy i metody dostępne w formacie Aspose.Words Document Object Model (DOM), aby uprościć najczęstsze zadania związane z tworzeniem dokumentów. Oznacza to, że możesz tworzyć i modyfikować treść dokumentów zarówno poprzez Aspose.Words DOM, co wymaga dobrego zrozumienia struktury drzewa, jak i przy użyciu narzędzia DocumentBuilder. DocumentBuilder to “fasada” złożonej struktury Document, która pozwala szybko i łatwo wstawiać treść i formatowanie.

Operacje możliwe w DocumentBuilder są również możliwe przy bezpośrednim użyciu klas Aspose.Words DOM. Jednak bezpośrednie użycie klas Aspose.Words DOM zwykle wymaga więcej linii kodu niż użycie DocumentBuilder.

Nawigacja w dokumencie

Nawigacja w dokumencie opiera się na koncepcji wirtualnego kursora, za pomocą którego można przenieść się w inne miejsce w dokumencie za pomocą różnych metod DocumentBuilder.move_to_XXX, takich jak move_to_document_start i move_to_field. Ten wirtualny kursor wskazuje, gdzie tekst zostanie wstawiony podczas wywoływania metod write, writeln, insert_break i innych. Więcej informacji na temat wirtualnego kursora można znaleźć w artykule “Nawigacja za pomocą kursora”.

Poniższy przykład kodu pokazuje, jak przejść do zakładki:

Tworzenie i modyfikowanie dokumentów

Aspose.Words API udostępnia kilka klas odpowiedzialnych za formatowanie różnych elementów dokumentu. Każda z klas zawiera właściwości formatujące powiązane z konkretnym elementem dokumentu, takim jak tekst, akapit, sekcja i inne. Na przykład klasa Font reprezentuje właściwości formatowania znaków, klasa ParagraphFormat reprezentuje właściwości formatowania akapitów i tak dalej. Obiekty tych klas są zwracane przez odpowiednie właściwości DocumentBuilder, które mają takie same nazwy jak klasy. Dzięki temu możesz uzyskać do nich dostęp i ustawić żądane formatowanie podczas tworzenia dokumentu.

Możesz także wstawić tekst, pole wyboru, obiekt ole, obrazy, zakładki, pola formularzy i inne elementy dokumentu w pozycji kursora, korzystając z metody Write lub dowolnej metody DocumentBuilder.insert_XXX, takiej jak insert_field, insert_html i podobnych metod.

Zobaczmy, jak utworzyć prosty dokument za pomocą DocumentBuilder.

Utwórz dokument za pomocą narzędzia DocumentBuilder

Aby rozpocząć, musisz utworzyć plik DocumentBuilder i powiązać go z obiektem Document. Tworzysz nową instancję DocumentBuilder, wywołując jej konstruktor i przekazując ją do obiektu Document w celu dołączenia do konstruktora.

Aby wstawić tekst, przekaż ciąg tekstowy, który chcesz wstawić do dokumentu, do metody write.

Poniższy przykład kodu pokazuje, jak utworzyć prosty dokument przy użyciu narzędzia do tworzenia dokumentów.

Określ formatowanie dokumentu

Właściwość font definiuje formatowanie tekstu. Obiekt ten zawiera różne atrybuty czcionki (nazwę czcionki, rozmiar czcionki, kolor itd.). Niektóre ważne atrybuty czcionek są również reprezentowane przez właściwości DocumentBuilder, aby umożliwić bezpośredni dostęp do nich. Są to właściwości logiczne Font.bold, Font.italic i Font.underline.

Poniższy przykład kodu pokazuje, jak wstawić sformatowany tekst za pomocą DocumentBuilder:

• font określa formatowanie znaków, które zostanie zastosowane do całego tekstu wstawianego od bieżącej pozycji w dokumencie.
• paragraph_format określa formatowanie akapitu bieżącego i wszystkich akapitów, które mają zostać wstawione.
• page_setup określa właściwości strony i sekcji dla bieżącej sekcji oraz całej sekcji, która zostanie wstawiona.
• cell_format i row_format określają właściwości formatowania, które zostaną zastosowane do komórek i wierszy tabeli, począwszy od bieżącej pozycji w dokumencie.

W tej sytuacji “bieżący” oznacza pozycję, akapit, sekcję, komórkę lub wiersz, w którym znajduje się kursor.

Należy pamiętać, że właściwości font, paragraph_format i page_setup są aktualizowane za każdym razem, gdy przechodzisz do innej lokalizacji w dokumencie, aby odzwierciedlić właściwości formatowania tej lokalizacji.