PreferredWidth

CellFormat.PreferredWidth property

Gibt die gewünschte Breite der Zelle zurück oder legt sie fest.

public PreferredWidth PreferredWidth { get; set; }

Bemerkungen

Die gewünschte Breite (zusammen mit der Option „Automatisch anpassen“) bestimmt, wie die tatsächliche Zellenbreite vom Tabellenlayout-Algorithmus berechnet wird. Das Tabellenlayout kann von Aspose.Words beim Speichern des Dokuments oder von Microsoft Word beim Anzeigen des Dokuments durchgeführt werden.

Die gewünschte Breite kann in Punkten oder Prozent angegeben werden. Die gewünschte Breite kann auch als „auto“ angegeben werden, d. h. es wird keine gewünschte Breite angegeben.

Der Standardwert istAuto.

Beispiele

Zeigt, wie Sie eine bevorzugte Breite für Tabellenzellen festlegen.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();

// Es gibt zwei Möglichkeiten, die Klasse „PreferredWidth“ auf Tabellenzellen anzuwenden.
// 1 – Legen Sie eine absolute bevorzugte Breite basierend auf Punkten fest:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

// 2 – Legen Sie eine relative bevorzugte Breite basierend auf dem Prozentsatz der Tabellenbreite fest:
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

builder.InsertCell();

// Eine Zelle ohne angegebene bevorzugte Breite nimmt den restlichen verfügbaren Platz ein.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// Jede Konfiguration der Eigenschaft „PreferredWidth“ erstellt ein neues Objekt.
Assert.AreNotEqual(table.FirstRow.Cells[1].CellFormat.PreferredWidth.GetHashCode(),
    builder.CellFormat.PreferredWidth.GetHashCode());

builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Automatically sized cell.");

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

Siehe auch

CellFormat.Orientation CellFormat.RightPadding