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.

aspose-words au niveau du document et de la section

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:

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.

mots-aspose-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:

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

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

mots-aspose-au-niveau-en-ligne

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:

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

tableau-ligne-cellule-aspose-mots