PreferredWidth

PreferredWidth class

Stellt einen Wert und seine Maßeinheit dar, die zur Angabe der bevorzugten Breite einer Tabelle oder Zelle verwendet wird.

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

public sealed class PreferredWidth

Eigenschaften

NameBeschreibung
Type { get; }Ruft die Maßeinheit ab, die für diesen bevorzugten Breitenwert verwendet wird.
Value { get; }Ruft den bevorzugten Breitenwert ab. Die Maßeinheit ist im angegebenType Eigenschaft.

Methoden

NameBeschreibung
static FromPercent(double)Eine Erstellungsmethode, die eine neue Instanz zurückgibt, die eine bevorzugte Breite darstellt, die als Prozentsatz angegeben wird.
static FromPoints(double)Eine Erstellungsmethode, die eine neue Instanz zurückgibt, die eine bevorzugte Breite darstellt, die mithilfe einer Anzahl von Punkten angegeben wird.
override Equals(object)Bestimmt, ob das angegebene Objekt den gleichen Wert wie das aktuelle Objekt hat.
Equals(PreferredWidth)Bestimmt, ob die angegebenePreferredWidth ist vom Wert her gleich dem StromPreferredWidth .
override GetHashCode()Dient als Hash-Funktion für diesen Typ.
override ToString()Gibt eine benutzerfreundliche Zeichenfolge zurück, die den Wert dieses Objekts anzeigt.

Felder

NameBeschreibung
static readonly AutoGibt eine Instanz zurück, die den Wert „Bevorzugte Breite ist nicht angegeben“ darstellt.

Bemerkungen

Die bevorzugte Breite kann als Prozentsatz, Anzahl der Punkte oder als spezieller „Keine/Auto“-Wert angegeben werden.

Die Instanzen dieser Klasse sind unveränderlich.

Beispiele

Zeigt, wie man eine Tabelle so einstellt, dass sie automatisch an 50 % der Seitenbreite angepasst 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.InsertCell();
builder.Write("Cell #3");

table.PreferredWidth = PreferredWidth.FromPercent(50);

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

Zeigt, wie man eine bevorzugte Breite für Tabellenzellen festlegt.

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, für die keine bevorzugte Breite angegeben ist, nimmt den Rest des verfügbaren Platzes 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

CellVerticalAlignment Enum PreferredWidthType Enum