Logické úrovně uzlů v dokumentu

Tato dokumentace někdy odkazuje na skupinu tříd uzlů, které patří do" úrovně “v dokumentu, například” bloková úroveň"," vložená úroveň “(také známá jako” vložená") nebo" řádková úroveň " uzly. Tyto úrovně v dokumentu jsou diferencovány čistě logicky a nejsou výslovně vyjádřeny dědičností nebo jinými prostředky Aspose.Words DOM. Úroveň uzlu se používá k popisu místa ve stromu dokumentů, kde by se uzel obvykle vyskytoval.

V předchozím článku jsme již hovořili o vztahu mezi uzly a skutečnosti, že ne všechny uzly mohou být dítětem jakýchkoli uzlů. Například buňka může být pouze podřízeným řádkem a řádek může být pouze podřízeným stolem atd. Tyto vztahy jsou také použitelné pro logické rozdělení uzlů na úrovně v dokumentu.

Následující části popisují logické úrovně uzlů v Aspose.Words a třídy, které patří do každé úrovně.

Logická úroveň dokumentu a sekce

Word dokument se skládá z jedné nebo více sekcí, reprezentovaných třídou Section a oddělených zlomy sekcí. Sekce může definovat vlastní velikost stránky, okraje, orientaci, počet textových sloupců a záhlaví a zápatí.

Document a Oddíl uzly úrovně mají strukturu, jak je znázorněno na následujícím obrázku.

Sekce obsahuje hlavní text, stejně jako záhlaví a zápatí pro první, sudé a liché stránky. Tyto různé “toky” textu se nazývají stories.

V Aspose.Words uzel Section obsahuje uzly Body a HeaderFooter příběhu. Objekt Body ukládá hlavní text. Objekty HeaderFooter ukládají text pro každou záhlaví a zápatí. Text libovolného příběhu se skládá z odstavců a tabulek, které jsou reprezentovány Objekty Paragraph a Table blokové úrovně.

Kromě toho může každý dokument Word obsahovat glosář, který je reprezentován uzlem GlossaryDocument v Aspose.Words. Glosář obsahuje položky BuildingBlocks, AutoText a AutoCorrect.

GlossaryDocument

Blok Logická Úroveň

Uzly na úrovni bloku představují kontejnery pro obsah a ovládací prvky obsahu a mohou se vyskytovat v podřízených uzlech stromu dokumentů v následujících uzlech:

• Tělo
• Záhlaví
• Zápatí
• Čára
• Komentář
• Tvar
• GroupShape
• Buňka
• StructuredDocumentTag

Uzly na úrovni bloků jsou reprezentovány následujícími třídami:

• Tables a Paragraphs, což jsou nejdůležitější uzly na úrovni bloku
• Záložky, které se vyskytují jak na úrovni bloku, tak na úrovni inline
• StructuredDocumentTag, které představují vlastní označení a mohou obsahovat jak obsah, Tak ovládací prvky obsahu

Následující diagram ukazuje prvky na úrovni bloku.

Inline Logická Úroveň

Uzly na úrovni Inline představují skutečný obsah dokumentu a mohou být obsaženy v následujících kontejnerech:

• Odstavec-nejběžnější kontejner
• SmartTag
• StructuredDocumentTag

Prvky na úrovni Inline jsou reprezentovány následujícími třídami:

• Run - běhy textu formátovaného jinak
• BookmarkStart a BookmarkEnd představují záložky
• CommentRangeStart, CommentRangeEnd, Comment a Footnote představují anotace
• FieldStart, FieldChar, FieldSeparator a FieldEnd, které představují znaky pole, a FormField představují Word pole
• SpecialChar představuje speciální znaky v dokumentu
• Shape a GroupShape představují tvary, kresby, obrázky atd.
• SmartTag a StructuredDocumentTag představují vlastní značku

Následující diagram ukazuje strukturu uzlů na úrovni inline.

Tvary v Microsoft Word zahrnují Office Art AutoShapes, textová pole, obrázky, objekty OLE a ovládací prvky ActiveX, které jsou všechny reprezentovány pomocí třídy Shape. Některé tvary mohou také obsahovat text, takže uzly tvarů v Aspose.Words mohou obsahovat uzly na úrovni bloku.

Tvary mohou být seskupeny uvnitř sebe pomocí GroupShape uzlů.

Poznámky pod čarou a komentáře mohou obsahovat text, proto uzly pod čarou a komentáře v Aspose.Words mohou obsahovat uzly na úrovni bloku.

Úroveň tabulky, řádku a uzlu buňky

Tabulka se skládá z uzlů řádků a buněk. Prvky tabulky jsou reprezentovány následujícími třídami:

• Row představuje řádek tabulky
• Cell představuje buňku tabulky
• StructuredDocumentTag představují vlastní značku

Následující diagram ukazuje struktury uzlů úrovně tabulky, řádku a buňky.