Poziomy logiczne węzłów w dokumencie

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

W poprzednim artykule mówiliśmy już o relacji między węzłami i fakcie, że nie wszystkie węzły mogą być dziećmi dowolnego węzła. Na przykład Cell może być tylko elementem podrzędnym Row, a Row może być tylko elementem podrzędnym Table i tak dalej. Zależności te mają również zastosowanie do logicznego podziału węzłów na poziomy w dokumencie.

W poniższych sekcjach opisano poziomy logiczne węzłów w Aspose.Words i klasy należące do każdego poziomu.

Poziom logiczny dokumentu i sekcji

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

Węzły poziomu Document i Section mają strukturę przedstawioną na poniższym schemacie.

słowa-aspose-na poziomie dokumentu i sekcji

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

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

Dodatkowo każdy dokument programu Word może zawierać glosariusz reprezentowany przez węzeł GlossaryDocument w formacie Aspose.Words. Dokument glosariusza zawiera wpisy w formatach building_blocks BuildingBlockType.AUTO_TEXT i BuildingBlockType.AUTO_CORRECT.

GlossaryDocument zawiera węzły BuildingBlock reprezentujące różne typy wpisów w dokumentach glosariusza. Każdy BuildingBlock zawiera sekcje, które można wstawiać, usuwać i kopiować do dokumentów.

Blokowy poziom logiczny

Węzły na poziomie bloków reprezentują kontenery dla treści i kontroli treści i mogą występować w węzłach podrzędnych drzewa dokumentu w następujących węzłach:

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
  • Bookmarks, który występuje zarówno na poziomie bloku, jak i na poziomie wbudowanym
  • StructuredDocumentTag, który reprezentuje znaczniki niestandardowe i może zawierać zarówno treść, jak i elementy sterujące zawartością

Poniższy diagram przedstawia elementy na poziomie bloków.

słowa na poziomie prywatnym

Wbudowany poziom logiczny

Węzły wbudowane reprezentują rzeczywistą treść dokumentu i mogą być zawarte w następujących kontenerach:

Elementy inline są reprezentowane przez następujące klasy:

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

słowa-aspose na poziomie inline

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

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

Poniższy diagram przedstawia struktury węzłów poziomów Table, Row i Cell.

tabela-wiersz-komórka-układa-słowa