Arbeiten mit Stilen und Themen
Die StyleCollection-Klasse wird zum Verwalten integrierter Stile und zum Anwenden benutzerdefinierter Einstellungen auf Stile verwendet.
Auf Stile zugreifen
Mithilfe der Document.styles-Eigenschaft können Sie eine Sammlung von im Dokument definierten Stilen abrufen. Diese Sammlung enthält sowohl die integrierten als auch die benutzerdefinierten Stile in einem Dokument. Ein bestimmter Stil kann über seinen Namen/Alias, seine Stilkennung oder seinen Index ermittelt werden. Das folgende Codebeispiel zeigt, wie Sie auf die im Dokument definierte Sammlung von Stilen zugreifen können.
So extrahieren Sie Inhalte basierend auf Stilen
Auf einer einfachen Ebene kann das Abrufen des Inhalts basierend auf Stilen aus einem Word-Dokument nützlich sein, um Absätze und Textabschnitte, die mit einem bestimmten Stil formatiert sind, zu identifizieren, aufzulisten und zu zählen. Beispielsweise müssen Sie möglicherweise bestimmte Arten von Inhalten im Dokument identifizieren, z. B. Beispiele, Titel, Referenzen, Schlüsselwörter, Abbildungsnamen und Fallstudien.
Um noch einen Schritt weiter zu gehen, kann dies auch dazu verwendet werden, die Struktur des Dokuments, die durch die verwendeten Stile definiert wird, zu nutzen, um das Dokument für eine andere Ausgabe, z. B. HTML, umzufunktionieren. Auf diese Weise ist tatsächlich die Aspose-Dokumentation aufgebaut, die Aspose.Words auf die Probe stellt. Ein mit Aspose.Words erstelltes Tool nimmt die Word-Quelldokumente und unterteilt sie in Themen auf bestimmten Überschriftenebenen. Mithilfe von Aspose.Words wird eine XML-Datei erstellt, die zum Erstellen des Navigationsbaums verwendet wird, den Sie links sehen können. Und dann konvertiert Aspose.Words jedes Thema in HTML.
Die Lösung zum Abrufen von mit bestimmten Stilen formatiertem Text in einem Word-Dokument ist in der Regel kostengünstig und unkompliziert mit Aspose.Words.
Die Lösung
Schauen wir uns ein Beispiel an, um zu veranschaulichen, wie einfach Aspose.Words das Abrufen von Inhalten basierend auf Stilen handhabt. In diesem Beispiel rufen wir Text ab, der mit einem bestimmten Absatzstil und einem Zeichenstil formatiert ist, aus einem Beispiel-Word-Dokument. Auf hoher Ebene umfasst dies Folgendes:
- Öffnen eines Word-Dokuments mit der Document-Klasse.
- Abrufen von Sammlungen aller Absätze und aller Läufe im Dokument.
- Auswahl nur der erforderlichen Absätze und Läufe. Konkret rufen wir aus diesem Beispiel-Word-Dokument Text ab, der mit dem Absatzstil “Überschrift 1” und dem Zeichenstil “Intense Emphasis” formatiert ist.
In diesem Beispieldokument ist der mit dem Absatzstil “Überschrift 1” formatierte Text “Tabulator einfügen”, “Schnellformate” und “Thema” und der mit dem Zeichenstil “Intensive Hervorhebung” formatierte Text besteht aus mehreren Instanzen von Blau, kursiver, fetter Text wie “Galerien” und “Gesamtbild”.
Der Code
Die Implementierung einer stilbasierten Abfrage ist im Aspose.Words-Dokumentobjektmodell recht einfach, da lediglich bereits vorhandene Tools verwendet werden. Für diese Lösung sind zwei Klassenmethoden implementiert:
- absätze_by_style_name – Diese Methode ruft ein Array der Absätze im Dokument ab, die einen bestimmten Stilnamen haben.
- läuft_nach_Stilname – Diese Methode ruft ein Array der Läufe im Dokument ab, die einen bestimmten Stilnamen haben. Beide Methoden sind sehr ähnlich, die einzigen Unterschiede bestehen in den Knotentypen und der Darstellung der Stilinformationen innerhalb der Absatz- und Laufknoten. Hier ist eine Implementierung von
paragraphs_by_style_name: Im folgenden Beispiel finden Sie alle Absätze, die mit dem angegebenen Stil formatiert sind.
Diese Implementierung verwendet auch die Document.get_child_nodes-Methode der Document-Klasse, die eine Sammlung aller Knoten mit dem angegebenen Typ zurückgibt, in diesem Fall in allen Absätzen.
Beachten Sie, dass der zweite Parameter der Document.get_child_nodes-Methode auf True gesetzt ist. Dadurch wird die Document.get_child_nodes-Methode gezwungen, rekursiv aus allen untergeordneten Knoten auszuwählen, anstatt nur die unmittelbar untergeordneten Knoten auszuwählen.
Es ist auch erwähnenswert, dass die Absätze-Sammlung keinen unmittelbaren Mehraufwand verursacht, da Absätze nur dann in diese Sammlung geladen werden, wenn Sie auf Elemente in ihnen zugreifen. Dann müssen Sie nur noch die Sammlung mit dem Standardoperator “foreach” durchgehen und Absätze mit dem angegebenen Stil zum Array “paragraphs_with_style” hinzufügen. Der Paragraph-Stilname kann in der Style.name-Eigenschaft des Paragraph.paragraph_format-Objekts gefunden werden. Die Implementierung von läuft_nach_Stilname ist nahezu identisch, obwohl wir offensichtlich NodeType.RUN verwenden, um Laufknoten abzurufen. Die Font.style-Eigenschaft eines Run-Objekts wird verwendet, um auf Stilinformationen in den Run-Knoten zuzugreifen. Im folgenden Beispiel finden Sie alle Läufe, die mit dem angegebenen Stil formatiert sind.
Wenn beide Abfragen implementiert sind, müssen Sie lediglich ein Dokumentobjekt übergeben und die Stilnamen des Inhalts angeben, den Sie abrufen möchten: Im folgenden Beispiel werden Abfragen ausgeführt und Ergebnisse angezeigt. Sie können die Vorlagendatei dieses Beispiels von Hier herunterladen.
Endresultat
Wenn alles erledigt ist, wird beim Ausführen des Beispiels die folgende Ausgabe angezeigt:
Wie Sie sehen, ist dies ein sehr einfaches Beispiel, das die Anzahl und den Text der gesammelten Absätze zeigt und im Beispiel-Word-Dokument ausgeführt wird.
Alle Stile aus der Vorlage kopieren
Es gibt Fälle, in denen Sie alle Stile von einem Dokument in ein anderes kopieren möchten. Mit der Document.copy_styles_from_template-Methode können Sie Stile aus der angegebenen Vorlage in ein Dokument kopieren. Wenn Stile von einer Vorlage in ein Dokument kopiert werden, werden gleichnamige Stile im Dokument neu definiert, damit sie mit den Stilbeschreibungen in der Vorlage übereinstimmen. Einzigartige Stile aus der Vorlage werden in das Dokument kopiert. Einzigartige Stile im Dokument bleiben erhalten. Das Below code-Beispiel zeigt, wie Stile von einem Dokument in ein anderes kopiert werden.
So manipulieren Sie Theme-Eigenschaften
Wir haben grundlegendes API in Aspose.Words hinzugefügt, um auf die Eigenschaften des Dokumentdesigns zuzugreifen. Derzeit enthält dieses API folgende öffentliche Objekte:
So erhalten Sie Theme-Eigenschaften:
Und so können Sie Theme-Eigenschaften festlegen: