Tabellenstil anwenden
Ein Tabellenstil definiert eine Reihe von Formatierungen, die einfach auf eine Tabelle angewendet werden können. Formatierungen wie Rahmen, Schattierung, Ausrichtung und Schriftart können in einem Tabellenstil festgelegt und für ein einheitliches Erscheinungsbild auf viele Tabellen angewendet werden.
Aspose.Words unterstützt das Anwenden eines Tabellenstils auf eine Tabelle und auch das Lesen von Eigenschaften eines beliebigen Tabellenstils. Tabellenstile bleiben beim Laden und Speichern auf folgende Weise erhalten:
- Tabellenstile in den Formaten DOCX und WordML bleiben beim Laden und Speichern in diesen Formaten erhalten
- Tabellenstile bleiben beim Laden und Speichern im DOC-Format erhalten (jedoch nicht in einem anderen Format)
- Beim Exportieren in andere Formate, Rendern oder Drucken werden Tabellenstile auf direkte Formatierungen in der Tabelle erweitert, sodass alle Formatierungen erhalten bleiben
Erstellen Sie einen Tabellenstil
Der Benutzer kann einen neuen Stil erstellen und ihn zur Stilsammlung hinzufügen. Die Add-Methode wird zum Erstellen eines neuen Tabellenstils verwendet.
Das folgende Codebeispiel zeigt, wie ein neuer benutzerdefinierter Tabellenstil erstellt wird:
Kopieren Sie einen vorhandenen Tabellenstil
Bei Bedarf können Sie mit der AddCopy-Methode einen Tabellenstil, der bereits in einem bestimmten Dokument vorhanden ist, in Ihre Stilsammlung kopieren.
Wichtig zu wissen ist, dass bei diesem Kopieren auch die verknüpften Stile mitkopiert werden.
Das folgende Codebeispiel zeigt, wie ein Stil aus einem Dokument in ein anderes Dokument importiert wird:
Wenden Sie einen vorhandenen Tabellenstil an
Aspose.Words stellt einen von der Style-Klasse geerbten TableStyle bereit. TableStyle erleichtert dem Benutzer die Anwendung verschiedener Stiloptionen wie Schattierung, Auffüllung, Einrückung, CellSpacing und Font usw.
Darüber hinaus stellt Aspose.Words die StyleCollection-Klasse und einige Eigenschaften der Table-Klasse bereit, um anzugeben, mit welchem Tabellenstil wir arbeiten: Style, StyleIdentifier, StyleName und StyleOptions.
Aspose.Words bietet außerdem eine ConditionalStyle-Klasse, die eine spezielle Formatierung darstellt, die auf einen bestimmten Bereich einer Tabelle mit einem zugewiesenen Tabellenstil angewendet wird, sowie ConditionalStyleCollection, das eine Sammlung von ConditionalStyle-Objekten darstellt. Diese Sammlung enthält einen permanenten Satz von Elementen, die ein Element für jeden Wert des ConditionalStyleType-Aufzählungstyps darstellen. Die ConditionalStyleType-Enumeration definiert alle möglichen Tabellenbereiche, für die eine bedingte Formatierung in einem Tabellenstil definiert werden kann.
In diesem Fall kann eine bedingte Formatierung für alle möglichen Tabellenbereiche definiert werden, die unter dem Aufzählungstyp ConditionalStyleType definiert sind.
Das folgende Codebeispiel zeigt, wie man eine bedingte Formatierung für die Kopfzeile der Tabelle definiert:
Sie können auch auswählen, auf welche Tabellenteile Stile angewendet werden sollen, z. B. erste Spalte, letzte Spalte, gebänderte Zeilen. Sie werden in der TableStyleOptions-Enumeration aufgeführt und über die StyleOptions-Eigenschaft angewendet. Die TableStyleOptions-Enumeration ermöglicht eine bitweise Kombination dieser Funktionen.
Das folgende Codebeispiel zeigt, wie eine neue Tabelle mit angewendetem Tabellenstil erstellt wird:
Die folgenden Bilder zeigen eine Darstellung des Table Styles in Microsoft Word und der entsprechenden Eigenschaften in Aspose.Words.
Übernehmen Sie die Formatierung aus dem Tabellenstil und wenden Sie sie als direkte Formatierung an
Aspose.Words bietet auch die ExpandTableStylesToDirectFormatting-Methode, um die in einem Tabellenstil gefundene Formatierung zu übernehmen und sie als direkte Formatierung auf die Zeilen und Zellen der Tabelle zu erweitern. Versuchen Sie, Formatierung mit Tabellenstil und Zellenstil zu kombinieren.
Das folgende Codebeispiel zeigt, wie man die Formatierung von Stilen auf Tabellenzeilen und Zellen als direkte Formatierung erweitert: