Wprowadzenie i tworzenie tabel

Aspose.Words umożliwia użytkownikom tworzenie tabel w dokumencie od podstaw i udostępnia kilka różnych metod, aby to zrobić. W tym artykule przedstawiono szczegółowe informacje na temat dodawania sformatowanych tabel do dokumentu przy użyciu poszczególnych metod, a także porównanie poszczególnych metod na końcu artykułu.

Domyślne style tabeli

Nowo utworzona tabela otrzymuje wartości domyślne podobne do tych używanych w Microsoft Word:

Właściwość tabeli	Domyślnie w Aspose.Words
Border Style	Single
Border Width	1/2 pt
Border Color	Black
Left and Right Padding	5.4 pts
AutoFit Mode	AutoFit to Window
Allow AutoFit	True
Tabela może być wbudowana, jeśli jest ciasno umieszczona, lub swobodna, jeśli można ją umieścić w dowolnym miejscu strony. Domyślnie Aspose.Words zawsze tworzy tabele wbudowane.

Utwórz tabelę za pomocą DocumentBuilder

W Aspose.Words użytkownicy mogą tworzyć tabele w dokumencie za pomocą DocumentBuilder. Podstawowy algorytm tworzenia tabeli jest następujący:

1. Uruchom tabelę za pomocą StartTable
2. Dodaj komórkę do tabeli za pomocą InsertCell – spowoduje to automatyczne rozpoczęcie nowego wiersza
3. Opcjonalnie użyj właściwości CellFormat, aby określić formatowanie komórki
4. Wstaw zawartość komórki, korzystając z odpowiednich metod DocumentBuilder, takich jak Writeln, InsertImage i inne
5. Powtarzaj kroki 2-4, aż rząd będzie kompletny
6. Wywołaj EndRow, aby zakończyć bieżący wiersz
7. Opcjonalnie użyj właściwości RowFormat, aby określić formatowanie wierszy
8. Powtarzaj kroki 2-7, aż tabela będzie kompletna
9. Zadzwoń do EndTable, aby zakończyć tworzenie tabeli

Ważne szczegóły:

• StartTable można także wywołać wewnątrz komórki i w takim przypadku rozpoczyna on tworzenie zagnieżdżonej tabeli w komórce.
• Po wywołaniu InsertCell tworzona jest nowa komórka, a wszelka treść dodana innymi metodami klasy DocumentBuilder zostanie dodana do bieżącej komórki. Aby utworzyć nową komórkę w tym samym wierszu, wywołaj ponownie InsertCell.
• Jeśli InsertCell zostanie wywołany bezpośrednio po EndRow i na końcu wiersza, tabela będzie kontynuowana w nowym wierszu.
• Metodę EndTable kończącą tabelę należy wywołać tylko raz po wywołaniu EndRow. Wywołanie EndTable przesuwa kursor z bieżącej komórki do pozycji bezpośrednio za tabelą.

Proces tworzenia tabeli można wyraźnie zobaczyć na poniższym obrazku:

Poniższy przykład kodu pokazuje, jak utworzyć prostą tabelę przy użyciu formatu DocumentBuilder z domyślnym formatowaniem:

Poniższy przykład kodu pokazuje, jak utworzyć sformatowaną tabelę za pomocą narzędzia DocumentBuilder:

Poniższy przykład kodu pokazuje, jak wstawić zagnieżdżoną tabelę za pomocą narzędzia DocumentBuilder:

Utwórz tabelę za pomocą DOM (Document Object Model)

Możesz wstawiać tabele bezpośrednio do DOM, dodając nowy węzeł Table w określonej pozycji.

Należy pamiętać, że zaraz po utworzeniu węzła tabeli sama tabela będzie całkowicie pusta, czyli nie będzie jeszcze zawierać wierszy i komórek. Aby wstawić wiersze i komórki do tabeli, dodaj odpowiednie węzły podrzędne Row i Cell do pliku DOM.

Ta metoda tworzenia tabeli wykorzystuje te same ustawienia domyślne tabeli, co w przypadku korzystania z DocumentBuilder.

Poniższy przykład kodu pokazuje, jak zbudować od podstaw nową tabelę, dodając odpowiednie węzły podrzędne do drzewa dokumentu:

##Create tabela z HTML

Aspose.Words obsługuje wstawianie treści do dokumentu ze źródła HTML przy użyciu metody InsertHtml. Dane wejściowe mogą być kompletną stroną HTML lub tylko częściowym fragmentem.

Korzystając z metody InsertHtml, użytkownicy mogą wstawiać tabele do dokumentu za pomocą znaczników tabel, takich jak <table>, <tr>, <td>.

Poniższy przykład kodu pokazuje, jak wstawić tabelę do dokumentu z ciągu zawierającego znaczniki HTML:

Wstaw kopię istniejącej tabeli

Często zdarza się, że trzeba utworzyć tabelę w oparciu o tabelę już istniejącą w dokumencie. Najłatwiejszym sposobem powielenia tabeli przy zachowaniu całego formatowania jest sklonowanie węzła tabeli przy użyciu metody Clone.

Tej samej techniki można użyć do dodania kopii istniejącego wiersza lub komórki do tabeli.

Poniższy przykład kodu pokazuje, jak powielić tabelę za pomocą konstruktorów węzłów:

Możesz pobrać przykładowy plik tego przykładu z Aspose.Words GitHub.

Poniższy przykład kodu pokazuje, jak sklonować ostatni wiersz tabeli i dołączyć go do tabeli:

Możesz pobrać przykładowy plik tego przykładu z Aspose.Words GitHub.

Jeśli planujesz utworzyć w dokumencie tabele, które rosną dynamicznie wraz z każdym rekordem ze źródła danych, powyższa metoda nie jest zalecana. Zamiast tego żądany wynik można łatwiej osiągnąć, używając Mail merge z regionami.

Porównaj sposoby tworzenia tabeli

Aspose.Words udostępnia kilka metod tworzenia nowych tabel w dokumencie. Każda metoda ma swoje zalety i wady, dlatego wybór często zależy od konkretnej sytuacji.

Przyjrzyjmy się bliżej tym sposobom tworzenia tabel i porównajmy ich zalety i wady:

metoda	Zalety	Niedogodności
Za pośrednictwem narzędzia DocumentBuilder	Standardowa metoda wstawiania tabel i innej zawartości dokumentu	Czasami trudno jest utworzyć wiele odmian tabel jednocześnie za pomocą tej samej instancji konstruktora
Za pośrednictwem DOM	Lepiej pasuje do otaczającego kodu, który tworzy i wstawia węzły bezpośrednio do DOM bez użycia DocumentBuilder	Tabela jest tworzona jako “pusta”: przed wykonaniem większości operacji należy wywołać EnsureMinimum, aby utworzyć brakujące węzły podrzędne
Z HTMLa	Można utworzyć nową tabelę ze źródła HTML przy użyciu tagów takich jak <table>, <tr>, <td>	Nie wszystkie możliwe formaty tabel Microsoft Word można zastosować do HTML
Klonowanie istniejącej tabeli	Można utworzyć kopię istniejącej tabeli, zachowując całe formatowanie wierszy i komórek	Zanim tabela będzie gotowa do użycia, należy usunąć odpowiednie węzły podrzędne