Logische Ebenen von Knoten in einem Dokument
In dieser Dokumentation wird manchmal auf eine Gruppe von Knotenklassen Bezug genommen, die zu einer “Ebene” in einem Dokument gehören, z. B. Knoten auf “Blockebene”, “Inline-Ebene” (auch bekannt als “Inline”) oder “Zeilenebene”.. Diese Ebenen in einem Dokument werden rein logisch unterschieden und nicht explizit durch Vererbung oder andere Aspose.Words-DOM-Mittel ausgedrückt. Die Knotenebene wird verwendet, um die Stelle im Dokumentbaum zu beschreiben, an der der Knoten normalerweise auftreten würde.
Im vorherigen Artikel haben wir bereits über die Beziehung zwischen Knoten und die Tatsache gesprochen, dass nicht alle Knoten einem beliebigen Knoten untergeordnet sein dürfen. Beispielsweise kann Cell nur ein untergeordnetes Row-Dokument sein, und ein Row kann nur ein untergeordnetes Table-Dokument sein und so weiter. Diese Beziehungen gelten auch für die logische Unterteilung von Knoten in Ebenen im Dokument.
In den folgenden Abschnitten werden die logischen Ebenen von Knoten in Aspose.Words und die Klassen beschrieben, die zu jeder Ebene gehören.
Logische Ebene des Dokuments und Abschnitts
Ein Word-Dokument besteht aus einem oder mehreren Abschnitten, die durch die Section-Klasse dargestellt und durch Abschnittswechsel getrennt werden. Ein Abschnitt kann seine eigene Seitengröße, Ränder, Ausrichtung, Anzahl der Textspalten sowie Kopf- und Fußzeilen definieren.
Knoten auf Document- und Section-Ebene haben die im folgenden Diagramm dargestellte Struktur.
Ein Abschnitt enthält den Haupttext sowie Kopf- und Fußzeilen für die erste, gerade und ungerade Seite. Diese verschiedenen “Textflüsse” werden stories genannt.
In Aspose.Words enthält der Section-Knoten die Body- und HeaderFooter-Story-Knoten. Das Body-Objekt speichert den Haupttext. Die HeaderFooter-Objekte speichern den Text für jede Kopf- und Fußzeile. Der Text jeder Geschichte besteht aus Absätzen und Tabellen, die jeweils durch die Paragraph- und Table-Objekte der Blockebene dargestellt werden.
Darüber hinaus kann jedes Word-Dokument ein Glossar enthalten, das durch den GlossaryDocument-Knoten in Aspose.Words dargestellt wird. Ein Glossardokument enthält building_blocks-BuildingBlockType.AUTO_TEXT- und BuildingBlockType.AUTO_CORRECT-Einträge.
GlossaryDocument enthält BuildingBlock-Knoten, die verschiedene Arten von Glossardokumenteinträgen darstellen. Jeder BuildingBlock enthält Abschnitte, die in Dokumente eingefügt, entfernt und kopiert werden können.
Logische Ebene blockieren
Knoten auf Blockebene stellen Container für Inhalte und Inhaltssteuerelemente dar und können in den untergeordneten Knoten der Dokumentstruktur in den folgenden Knoten vorkommen:
Knoten auf Blockebene werden durch die folgenden Klassen dargestellt:
- Tables und Paragraphs, die wichtigsten Knoten auf Blockebene
- Bookmarks, das sowohl auf Blockebene als auch auf Inline-Ebene auftritt
- StructuredDocumentTag, das benutzerdefiniertes Markup darstellt und sowohl Inhalte als auch Inhaltssteuerelemente enthalten kann
Das folgende Diagramm zeigt Elemente auf Blockebene.
Inline-logische Ebene
Knoten auf Inline-Ebene stellen den tatsächlichen Inhalt des Dokuments dar und können in den folgenden Containern enthalten sein:
- Paragraph – der am häufigsten verwendete Container
- SmartTag
- StructuredDocumentTag
Elemente auf Inline-Ebene werden durch die folgenden Klassen dargestellt:
- Run – anders formatierte Textläufe
- BookmarkStart und BookmarkEnd repräsentieren Lesezeichen
- CommentRangeStart, CommentRangeEnd, Comment und Footnote repräsentieren Anmerkungen
- FieldStart, FieldChar, FieldSeparator und FieldEnd, die Feldzeichen darstellen, und FormField stellen Word-Felder dar
- SpecialChar repräsentiert Sonderzeichen im Dokument
- Shape und GroupShape repräsentieren Formen, Zeichnungen, Bilder usw.
- SmartTag und StructuredDocumentTag stellen benutzerdefiniertes Markup dar
Das folgende Diagramm zeigt die Knotenstruktur auf Inline-Ebene.
Zu den Formen in Microsoft Word gehören Office Art AutoShapes, Textfelder, Bilder, OLE-Objekte und ActiveX-Steuerelemente, die alle mithilfe der Shape-Klasse dargestellt werden. Einige Formen können auch Text enthalten, sodass Formknoten in Aspose.Words Knoten auf Blockebene enthalten können.
Mithilfe von GroupShape-Knoten können Formen ineinander gruppiert werden.
Tabellen-, Zeilen- und Zellenknotenebene
Die Tabelle besteht aus Knoten von Zeilen und Zellen. Table-Elemente werden durch die folgenden Klassen dargestellt:
- Row repräsentiert eine Tabellenzeile
- Cell repräsentiert eine Tabellenzelle
- StructuredDocumentTag steht für benutzerdefiniertes Markup
Das folgende Diagramm zeigt die Knotenstrukturen der Ebenen Table, Row und Cell.
