CellFormat

CellFormat class

Stellt die gesamte Formatierung für eine Tabellenzelle dar.

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

public class CellFormat

Eigenschaften

Name	Beschreibung
Borders { get; }	Ruft eine Sammlung von Zellrändern ab.
BottomPadding { get; set; }	Gibt den Abstand (in Punkten) zurück, der unterhalb des Zellinhalts hinzugefügt werden soll, oder legt ihn fest.
FitText { get; set; }	WennWAHR , passt den Text in die Zelle ein und komprimiert jeden Absatz auf die Breite der Zelle.
HideMark { get; set; }	Gibt die Sichtbarkeit der Zellenmarkierung zurück oder legt sie fest.
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 Zelleninhalt hinzugefügt werden soll, oder legt ihn fest.
Orientation { get; set; }	Gibt die Ausrichtung des Textes in einer Tabellenzelle zurück oder legt sie fest.
PreferredWidth { get; set; }	Gibt die gewünschte Breite der Zelle zurück oder legt sie fest.
RightPadding { get; set; }	Gibt den Abstand (in Punkten) zurück, der rechts vom Zelleninhalt hinzugefügt werden soll, oder legt ihn fest.
Shading { get; }	Gibt einenShading 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 ihn fest.
VerticalAlignment { get; set; }	Gibt die vertikale Ausrichtung des Textes 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; }	Ruft die Breite der Zelle in Punkten ab.
WrapText { get; set; }	WennWAHR , umbrechen Sie den Text für die Zelle.

Methoden

Name	Beschreibung
ClearFormatting()	Setzt die Zellenformatierung auf die Standardeinstellung zurück. Die Breite der Zelle wird nicht geändert.
SetPaddings(double, double, double, double)	Legt den Abstand (in Punkten) fest, der links/oben/rechts/unten zum Zelleninhalt 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 eine Tabelle mit benutzerdefinierten Rändern erstellt wird.

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

builder.StartTable();

// Festlegen von Tabellenformatierungsoptionen für einen Dokumentgenerator
// 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();

// Das Ändern der Formatierung wird 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();

// Erhöhen Sie die Zeilenhöhe, damit der vertikale Text hineinpasst.
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

• namensraum Aspose.Words.Tables
• Montage Aspose.Words