Niveaux logiques des nœuds dans un document

Cette documentation fait parfois référence à un groupe de classes de nœuds comme appartenant à un “niveau” dans un document, tel que les nœuds “niveau bloc”, “niveau en ligne” (également appelé “en ligne”) ou “niveau ligne”.. Ces niveaux dans un document sont différenciés de manière purement logique et ne sont pas explicitement exprimés par héritage ou par d’autres moyens Aspose.Words DOM. Le niveau nœud est utilisé pour décrire l’endroit dans l’arborescence du document où le nœud apparaîtrait généralement.

Dans l’article précédent, nous avons déjà parlé de la relation entre les nœuds et du fait que tous les nœuds ne sont pas autorisés à être les enfants de n’importe quel nœud. Par exemple, Cell ne peut être qu’un enfant Row, et un Row ne peut être qu’un enfant Table, et ainsi de suite. Ces relations sont également applicables pour la division logique des nœuds en niveaux dans le document.

Les sections suivantes décrivent les niveaux logiques des nœuds dans Aspose.Words et les classes qui appartiennent à chaque niveau.

Niveau logique du document et de la section

Un document Word se compose d’une ou plusieurs sections, représentées par la classe Section et séparées par des sauts de section. Une section peut définir sa propre taille de page, ses marges, son orientation, son nombre de colonnes de texte ainsi que ses en-têtes et pieds de page.

Les nœuds de niveau Document et Section ont la structure indiquée dans le diagramme suivant.

Une section contient le texte principal, ainsi que les en-têtes et pieds de page des premières pages paires et impaires. Ces différents “flux” de texte sont appelés stories.

Dans Aspose.Words, le nœud Section contient les nœuds d’histoire Body et HeaderFooter. L’objet Body stocke le texte principal. Les objets HeaderFooter stockent le texte de chaque en-tête et pied de page. Le texte de toute histoire est constitué de paragraphes et de tableaux, respectivement représentés par les objets Paragraph et Table du niveau Bloc.

De plus, chaque document Word peut contenir un glossaire, représenté par le nœud GlossaryDocument dans Aspose.Words. Un document de glossaire contient des entrées building_blocks BuildingBlockType.AUTO_TEXT et BuildingBlockType.AUTO_CORRECT.

GlossaryDocument comprend des nœuds BuildingBlock représentant différents types d’entrées de documents de glossaire. Chaque BuildingBlock contient des sections qui peuvent être insérées, supprimées et copiées dans des documents.

Bloquer le niveau logique

Les nœuds de niveau bloc représentent des conteneurs pour le contenu et les contrôles de contenu, et peuvent apparaître dans les nœuds enfants de l’arborescence du document dans les nœuds suivants:

• Body
• Header
• Footer
• Footnote
• Comment
• Shape
• GroupShape
• Cell
• StructuredDocumentTag

Les nœuds au niveau bloc sont représentés par les classes suivantes:

• Tables et Paragraphs, qui sont les nœuds au niveau bloc les plus importants
• Bookmarks, qui se produit à la fois au niveau du bloc et au niveau en ligne
• StructuredDocumentTag, qui représente un balisage personnalisé et peut contenir à la fois du contenu et des contrôles de contenu

Le diagramme suivant montre les éléments au niveau du bloc.

Niveau logique en ligne

Les nœuds de niveau en ligne représentent le contenu réel du document et peuvent être contenus dans les conteneurs suivants:

• Paragraph – le conteneur le plus courant
• SmartTag
• StructuredDocumentTag

Les éléments de niveau en ligne sont représentés par les classes suivantes:

• Run – séquences de texte formatées différemment
• BookmarkStart et BookmarkEnd représentent des signets
• CommentRangeStart, CommentRangeEnd, Comment et Footnote représentent des annotations
• FieldStart, FieldChar, FieldSeparator et FieldEnd qui représentent les caractères des champs, et FormField représentent les champs Word
• SpecialChar représente des caractères spéciaux dans le document
• Shape et GroupShape représentent des formes, des dessins, des images, etc.
• SmartTag et StructuredDocumentTag représentent un balisage personnalisé

Le diagramme suivant montre la structure des nœuds de niveau en ligne.

Les formes dans Microsoft Word incluent les formes automatiques Office Art, les zones de texte, les images, les objets OLE et les contrôles ActiveX, qui sont tous représentés à l’aide de la classe Shape. Certaines formes peuvent également contenir du texte, de sorte que les nœuds de forme en Aspose.Words peuvent contenir des nœuds au niveau du bloc.

Les formes peuvent être regroupées les unes dans les autres à l’aide de nœuds GroupShape.

Les notes de bas de page et les commentaires peuvent contenir du texte, par conséquent les nœuds Footnote et Comment en Aspose.Words peuvent contenir des nœuds au niveau du bloc.

Niveau de nœud de table, de ligne et de cellule

Le tableau est constitué de nœuds de lignes et de cellules. Les éléments Table sont représentés par les classes suivantes:

• Row représente une ligne de tableau
• Cell représente une cellule de tableau
• StructuredDocumentTag représente un balisage personnalisé

Le diagramme suivant montre les structures de nœuds des niveaux Table, Row et Cell.