Logiczne poziomy węzłów w dokumencie

Ta dokumentacja czasami odnosi się do grupy klas węzłów jako należących do “poziomu” w dokumencie, takich jak węzły “na poziomie bloku”, “na poziomie wbudowanym” (znane również jako “wbudowane”) lub “na poziomie wiersza”. Te poziomy w dokumencie są zróżnicowane czysto logicznie i nie są wyraźnie wyrażone przez dziedziczenie lub inne Aspose.Words DOM środki. Poziom węzła służy do opisania miejsca w drzewie dokumentów, w którym zwykle występuje węzeł.

W poprzednim artykule mówiliśmy już o związku między węzłami oraz o tym, że nie wszystkie węzły mogą być potomkami dowolnych węzłów. Na przykład komórka może być tylko dzieckiem wiersza, a wiersz może być tylko dzieckiem tabeli i tak dalej. Relacje te mają również zastosowanie do logicznego podziału węzłów na poziomy w dokumencie.

Poniższe sekcje opisują logiczne poziomy węzłów w Aspose.Words I klasy należące do każdego poziomu.

Poziom logiczny dokumentu i sekcji

Dokument Word składa się z jednej lub więcej sekcji reprezentowanych przez klasę Section i oddzielonych podziałami sekcji. Sekcja może definiować własny rozmiar strony, marginesy, orientację, liczbę kolumn tekstowych oraz nagłówki i stopki.

Document oraz Sekcja węzły poziomu mają strukturę, jak pokazano na poniższym schemacie.

Sekcja zawiera tekst główny, a także nagłówki i stopki dla pierwszej, parzystej i nieparzystej strony. Te różne “przepływy” tekstu nazywane są stories.

W Aspose.Words węzeł Section zawiera Body i HeaderFooter węzły historii. Obiekt Body przechowuje tekst główny. Obiekty HeaderFooter przechowują tekst dla każdego nagłówka i stopki. Tekst każdej historii składa się z akapitów i tabel, odpowiednio reprezentowanych przez obiekty Paragraph i Table na poziomie bloku.

Dodatkowo każdy dokument Word może zawierać słowniczek, który jest reprezentowany przez węzeł GlossaryDocument w Aspose.Words. Dokument słowniczek zawiera wpisy BuildingBlocks, AutoText i AutoCorrect.

GlossaryDocument

Blokuj Poziom Logiczny

Węzły na poziomie bloku reprezentują kontenery zawartości i kontrolki zawartości i mogą występować w węzłach podrzędnych drzewa dokumentów w następujących węzłach:

• Ciało
• Nagłówek
• Stopka
• Przypisy
• Komentarz
• Kształt
• GroupShape
• Komórka
• StructuredDocumentTag

Węzły na poziomie bloków są reprezentowane przez następujące klasy:

• Tables i Paragraphs, które są najważniejszymi węzłami na poziomie bloków
• Zakładki, które występują zarówno na poziomie bloku, jak i na poziomie inline
• StructuredDocumentTag, które reprezentują niestandardowe znaczniki i mogą zawierać zarówno treść, jak i kontrolki treści

Poniższy diagram pokazuje elementy na poziomie bloku.

Wbudowany Poziom Logiczny

Węzły na poziomie wbudowanym reprezentują rzeczywistą zawartość dokumentu i mogą być zawarte w następujących kontenerach:

• Akapit-najczęstszy Pojemnik
• SmartTag
• StructuredDocumentTag

Elementy na poziomie wbudowanym są reprezentowane przez następujące klasy:

• Run - przebieg tekstu sformatowanego inaczej
• BookmarkStart i BookmarkEnd reprezentują zakładki
• CommentRangeStart, CommentRangeEnd, Comment i Footnote reprezentują adnotacje
• FieldStart, FieldChar, FieldSeparator i FieldEnd, które reprezentują znaki pól, a FormField reprezentują Word pól
• SpecialChar reprezentuje znaki specjalne w dokumencie
• Shape i GroupShape reprezentują kształty, rysunki, obrazy itp.
• SmartTag i StructuredDocumentTag reprezentują niestandardowe znaczniki

Poniższy diagram przedstawia strukturę węzłów na poziomie wbudowanym.

Kształty w Microsoft Word obejmują grafikę pakietu Office AutoShapes, pola tekstowe, obrazy, OLE obiekty i formanty ActiveX, z których wszystkie są reprezentowane przy użyciu klasy Shape. Niektóre kształty mogą również zawierać tekst, więc węzły kształtu w Aspose.Words mogą zawierać węzły na poziomie bloku.

Kształty można grupować wewnątrz siebie za pomocą węzłów GroupShape.

Przypisy i komentarze mogą zawierać tekst, dlatego węzły przypisów i komentarzy w Aspose.Words mogą zawierać węzły na poziomie bloku.

Poziom węzła tabeli, wiersza i komórki

Tabela składa się z węzłów wierszy i komórek. Elementy tabeli są reprezentowane przez następujące klasy:

• Row reprezentuje wiersz tabeli
• Cell reprezentuje komórkę tabeli
• StructuredDocumentTag reprezentują niestandardowe znaczniki

Poniższy diagram przedstawia struktury węzłów tabeli, wierszy i poziomów komórek.