Przegląd budowy dokumentów
DocumentBuilder jest potężną klasą, która łączy się z Document i umożliwia budowanie dynamicznych dokumentów od podstaw lub dodawanie nowych elementów do istniejącego dokumentu.
DocumentBuilder zawiera metody wprowadzania tekstu, pól kontrolnych, obiektów ole, akapitów, list, tabel, obrazów i innych elementów treści. Pozwala na określenie czcionek, paragrafów lub sekcji formatowania i wykonywanie innych operacji.
Budowniczy dokumentów lub Aspose.Words DOM
DocumentBuilder uzupełnia klasy i metody dostępne w Aspose.Words Document Object Model (DOM) uproszczenie najpowszechniejszych zadań związanych z budowaniem dokumentów. Oznacza to, że można tworzyć i modyfikować zawartość dokumentów zarówno poprzez Aspose.Words DOM, co wymaga dobrego zrozumienia struktury drzewa i korzystania z DocumentBuilder. W DocumentBuilder jest “fasadą” dla kompleksu Document struktury, która pozwala na szybkie i łatwe wstawianie treści i formatowanie.
Operacje, które są możliwe z DocumentBuilder są również możliwe przy użyciu klas Aspose.Words DOM bezpośrednio. Jednak Aspose.Words DOM klasy bezpośrednio zwykle wymagają więcej linii kodu niż za pomocą DocumentBuilder.
Nawigacja dokumentów
Nawigacja dokumentu opiera się na koncepcji wirtualnego kursora, z którym można przenieść się do innej lokalizacji w dokumencie za pomocą różnych DocumentBuilder.MoveToXXX metody takie jak MoveToDocumentStart oraz MoveToField. Ten wirtualny kursor wskazuje, gdzie tekst zostanie wstawiony podczas wywoływania metod Write, Writeln, InsertBreak, i innych. Zobacz następujący artykuł “Nawigacja kursorem”, aby dowiedzieć się więcej o wirtualnym kursorze.
Poniższy przykład kodu pokazuje jak przejść do zakładki:
Tworzenie i modyfikowanie dokumentów
Aspose.Words API zawiera kilka klas odpowiedzialnych za formatowanie różnych elementów dokumentu. Każda z klas obejmuje właściwości formatowania związane z określonym elementem dokumentu, takim jak tekst, paragraf, sekcja i inne. Na przykład: Font class reprezentuje właściwości formatowania znaków, ParagraphFormat klasa reprezentuje właściwości formatowania paragrafów, itd. Obiekty tych klas są zwracane przez odpowiedni DocumentBuilder właściwości, które mają te same nazwy co klasy. Dlatego można do nich uzyskać dostęp i ustawić wymagane formatowanie podczas tworzenia dokumentu.
Można również umieścić tekst, pole wyboru, obiekt ole, obrazy, zakładki, pola formularza i inne elementy dokumentu w pozycji kursora za pomocą Write metoda lub jakikolwiek z DocumentBuilder.InsertXXX metody, takie jak InsertField, InsertHtml, i podobne metody.
Zobaczmy jak stworzyć prosty dokument używając DocumentBuilder.
Utwórz dokument używając DocumentBuilder
Aby rozpocząć, trzeba utworzyć DocumentBuilder i połączyć go z Document obiekt. Tworzysz nowy przykład DocumentBuilder przez wywołanie jego konstruktora i przekazać go do Document obiekt do przywiązania do budowniczego.
Aby dodać tekst, należy przekazać ciąg tekstu, który należy umieścić w dokumencie do Write Metoda.
Poniższy przykład kodu pokazuje, jak stworzyć prosty dokument za pomocą buildera dokumentów.
Określić formatowanie dokumentu
W Font właściwość definiuje formatowanie tekstu. Obiekt ten zawiera różne atrybuty czcionki (nazwa czcionki, rozmiar czcionki, kolor itp.). Niektóre ważne atrybuty czcionek są również reprezentowane przez DocumentBuilder nieruchomości umożliwiające bezpośredni dostęp do nich. To są Font.Bold, Font.Italic, oraz Font.Underline właściwości boolean.
Poniższy przykład kodu pokazuje jak wstawić sformatowany tekst używając DocumentBuilder:
- Font określa formatowanie znaków, które będą stosowane do całego tekstu dodanego z bieżącej pozycji w dokumencie.
- ParagraphFormat określa formatowanie paragrafu dla bieżącego i wszystkich dodanych ustępów.
- PageSetup Określa właściwości strony i sekcji dla bieżącej sekcji i całej sekcji, która zostanie dodana.
- CellFormat oraz RowFormat określić właściwości formatowania, które będą stosowane do komórek tabeli i wierszy z bieżącej pozycji w dokumencie począwszy od.
W tej sytuacji “prąd” oznacza pozycję, paragraf, sekcję, komórkę lub wiersz, w którym znajduje się kursor.