CellFormat

CellFormat class

Stellt alle Formatierungen für eine Tabellenzelle dar.

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

public class CellFormat

Eigenschaften

NameBeschreibung
Borders { get; }Ruft eine Sammlung von Rändern der Zelle ab.
BottomPadding { get; set; }Gibt den Abstand (in Punkten) zurück, der unter dem Inhalt der Zelle hinzugefügt werden soll, oder legt diesen fest.
FitText { get; set; }WennWAHR , passt den Text in die Zelle ein und komprimiert jeden Absatz auf die Breite der Zelle.
HorizontalMerge { get; set; }Gibt an, wie die Zelle horizontal mit anderen Zellen in der Zeile zusammengeführt wird.
LeftPadding { get; set; }Gibt den Abstand (in Punkten) zurück, der links vom Inhalt der Zelle hinzugefügt werden soll, oder legt ihn fest.
Orientation { get; set; }Gibt die Ausrichtung des Texts in einer Tabellenzelle zurück oder legt sie fest.
PreferredWidth { get; set; }Gibt die bevorzugte Breite der Zelle zurück oder legt sie fest.
RightPadding { get; set; }Gibt den Abstand (in Punkten) zurück, der rechts vom Inhalt der Zelle hinzugefügt werden soll, oder legt ihn fest.
Shading { get; }Gibt a zurückShading Objekt, das sich auf die Schattierungsformatierung für die Zelle bezieht.
TopPadding { get; set; }Gibt den Abstand (in Punkten) zurück, der über dem Inhalt der Zelle hinzugefügt werden soll, oder legt diesen fest.
VerticalAlignment { get; set; }Gibt die vertikale Ausrichtung des Texts in der Zelle zurück oder legt sie fest.
VerticalMerge { get; set; }Gibt an, wie die Zelle vertikal mit anderen Zellen zusammengeführt wird.
Width { get; set; }Ermittelt die Breite der Zelle in Punkten.
WrapText { get; set; }WennWAHR , Text für die Zelle umbrechen.

Methoden

NameBeschreibung
ClearFormatting()Setzt die Standardzellenformatierung zurück. Ändert die Breite der Zelle nicht.
SetPaddings(double, double, double, double)Legt die Menge an Platz (in Punkten) fest, die links/oben/rechts/unten zum Inhalt der Zelle hinzugefügt werden soll.

Beispiele

Zeigt, wie die Formatierung einer Tabellenzelle geändert wird.

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// Verwenden Sie die Eigenschaft „CellFormat“ einer Zelle, um eine Formatierung festzulegen, die das Erscheinungsbild dieser Zelle ändert.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

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

Zeigt, wie das Format von Zeilen und Zellen in einer Tabelle geändert wird.

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// Verwenden Sie die Eigenschaft „RowFormat“ der ersten Zeile, um die Formatierung zu ändern
// des Inhalts aller Zellen in dieser Zeile.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// Verwenden Sie die Eigenschaft „CellFormat“ der ersten Zelle in der letzten Zeile, um die Formatierung des Inhalts dieser Zelle zu ändern.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

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

Zeigt, wie man eine Tabelle mit benutzerdefinierten Rändern erstellt.

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

builder.StartTable();

// Festlegen von Tabellenformatierungsoptionen für einen Dokumentersteller
// wendet sie auf jede Zeile und Zelle an, die wir damit hinzufügen.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// Wenn Sie die Formatierung ändern, wird sie auf die aktuelle Zelle angewendet.
// und alle neuen Zellen, die wir anschließend mit dem Builder erstellen.
// Dies hat keine Auswirkungen auf die Zellen, die wir zuvor hinzugefügt haben.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// Zeilenhöhe erhöhen, um sie an den vertikalen Text anzupassen.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTable.docx");

Siehe auch

CellCollection Class CellMerge Enum