ConditionalStyle

ConditionalStyle class

Stellt eine spezielle Formatierung dar, die auf einen bestimmten Bereich einer Tabelle mit zugewiesenem Tabellenstil angewendet wird.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Tabellen Dokumentationsartikel.

public sealed class ConditionalStyle

Eigenschaften

NameBeschreibung
Borders { get; }Ruft die Sammlung von Standard-Zellenrändern für den bedingten Stil ab.
BottomPadding { get; set; }Ruft den Abstand (in Punkten) ab, der unterhalb des Inhalts von Tabellenzellen hinzugefügt werden soll, oder legt diesen fest.
Font { get; }Ruft die Zeichenformatierung des bedingten Stils ab.
LeftPadding { get; set; }Ruft die Menge an Platz (in Punkten) ab, die links vom Inhalt von Tabellenzellen hinzugefügt werden soll, oder legt diese fest.
ParagraphFormat { get; }Ruft die Absatzformatierung des bedingten Stils ab.
RightPadding { get; set; }Ruft die Menge an Platz (in Punkten) ab, die rechts vom Inhalt von Tabellenzellen hinzugefügt werden soll, oder legt diese fest.
Shading { get; }Ruft a abShading Objekt, das sich auf die Schattierungsformatierung für diesen bedingten Stil bezieht.
TopPadding { get; set; }Ruft die Menge an Platz (in Punkten) ab, die oberhalb des Inhalts von Tabellenzellen hinzugefügt werden soll, oder legt diese fest.
Type { get; }Ruft den Tabellenbereich ab, auf den sich dieser bedingte Stil bezieht.

Methoden

NameBeschreibung
ClearFormatting()Löscht die Formatierung dieses bedingten Stils.
override Equals(object)Vergleicht diesen bedingten Stil mit dem angegebenen Objekt.
override GetHashCode()Berechnet den Hash-Code für dieses Objekt.

Beispiele

Zeigt, wie mit bestimmten Bereichsstilen einer Tabelle gearbeitet wird.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell 1");
builder.InsertCell();
builder.Write("Cell 2");
builder.EndRow();
builder.InsertCell();
builder.Write("Cell 3");
builder.InsertCell();
builder.Write("Cell 4");
builder.EndTable();

// Einen benutzerdefinierten Tabellenstil erstellen.
TableStyle tableStyle = (TableStyle)doc.Styles.Add(StyleType.Table, "MyTableStyle1");

// Bedingte Stile sind Formatierungsänderungen, die sich nur auf einige Zellen der Tabelle auswirken
// basierend auf einem Prädikat, z. B. den Zellen in der letzten Zeile.
// Nachfolgend finden Sie drei Möglichkeiten, auf die bedingten Stile eines Tabellenstils aus der „ConditionalStyles“-Sammlung zuzugreifen.
// 1 - Nach Stiltyp:
tableStyle.ConditionalStyles[ConditionalStyleType.FirstRow].Shading.BackgroundPatternColor = Color.AliceBlue;

// 2 - Nach Index:
tableStyle.ConditionalStyles[0].Borders.Color = Color.Black;
tableStyle.ConditionalStyles[0].Borders.LineStyle = LineStyle.DotDash;
Assert.AreEqual(ConditionalStyleType.FirstRow, tableStyle.ConditionalStyles[0].Type);

// 3 - Als Eigenschaft:
tableStyle.ConditionalStyles.FirstRow.ParagraphFormat.Alignment = ParagraphAlignment.Center;

// Auffüllung und Textformatierung auf bedingte Stile anwenden.
tableStyle.ConditionalStyles.LastRow.BottomPadding = 10;
tableStyle.ConditionalStyles.LastRow.LeftPadding = 10;
tableStyle.ConditionalStyles.LastRow.RightPadding = 10;
tableStyle.ConditionalStyles.LastRow.TopPadding = 10;
tableStyle.ConditionalStyles.LastColumn.Font.Bold = true;

// Alle möglichen Stilbedingungen auflisten.
using (IEnumerator<ConditionalStyle> enumerator = tableStyle.ConditionalStyles.GetEnumerator())
{
    while (enumerator.MoveNext())
    {
        ConditionalStyle currentStyle = enumerator.Current;
        if (currentStyle != null) Console.WriteLine(currentStyle.Type);
    }
}

// Den benutzerdefinierten Stil, der alle bedingten Stile enthält, auf die Tabelle anwenden.
table.Style = tableStyle;

// Unser Stil wendet standardmäßig einige bedingte Stile an.
Assert.AreEqual(TableStyleOptions.FirstRow | TableStyleOptions.FirstColumn | TableStyleOptions.RowBands, 
    table.StyleOptions);

// Alle anderen Stile müssen wir selbst über die Eigenschaft „StyleOptions“ aktivieren.
table.StyleOptions = table.StyleOptions | TableStyleOptions.LastRow | TableStyleOptions.LastColumn;

doc.Save(ArtifactsDir + "Table.ConditionalStyles.docx");

Siehe auch