PreferredWidth

PreferredWidth class

Representerar ett värde och dess måttenhet som används för att ange den föredragna bredden på en tabell eller en cell.

public sealed class PreferredWidth

Egenskaper

namn Beskrivning
Type { get; } Hämtar måttenheten som används för detta föredragna breddvärde.
Value { get; } Hämtar önskat breddvärde. Måttenheten anges iType egenskap.

Metoder

namn Beskrivning
static FromPercent(double) En skapandemetod som returnerar en ny instans som representerar en föredragen bredd som anges i procent.
static FromPoints(double) En skapandemetod som returnerar en ny instans som representerar en föredragen bredd som anges med ett antal punkter.
override Equals(object) Bestämmer om det angivna objektet har samma värde som det aktuella objektet.
Equals(PreferredWidth) Bestämmer om den angivna PreferredWidth är lika i värde med den aktuella PreferredWidth.
override GetHashCode() Fungerar som en hashfunktion för denna typ.
override ToString() Returnerar en användarvänlig sträng som visar värdet på detta objekt.

Fält

namn Beskrivning
static readonly Auto Returnerar en instans som representerar värdet “föredragen bredd är inte angiven”.

Anmärkningar

Önskad bredd kan anges i procent, antal poäng eller ett speciellt “ingen/auto”-värde.

Förekomsterna av denna klass är oföränderliga.

Exempel

Visar hur du ställer in en tabell för att automatiskt anpassa till 50 % av sidans bredd.

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");

Visar hur man ställer in en föredragen bredd för tabellceller.

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

// Det finns två sätt att tillämpa klassen "PreferredWidth" på tabellceller.
// 1 - Ställ in en absolut föredragen bredd baserat på punkter:
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 - Ställ in en relativ föredragen bredd baserat på procent av tabellens bredd:
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();

// En cell utan angiven önskad bredd kommer att ta upp resten av det tillgängliga utrymmet.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// Varje konfiguration av egenskapen "PreferredWidth" skapar ett nytt 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");

Se även