PreferredWidth

PreferredWidth class

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

För att lära dig mer, besökArbeta med tabeller dokumentationsartikel.

public sealed class PreferredWidth

Egenskaper

namnBeskrivning
Type { get; }Hämtar måttenheten som används för detta önskade breddvärde.
Value { get; }Hämtar önskat breddvärde. Måttenheten anges iType egendom.

Metoder

namnBeskrivning
static FromPercent(double)En skapandemetod som returnerar en ny instans som representerar en önskad bredd angiven som en procentandel.
static FromPoints(double)En skapandemetod som returnerar en ny instans som representerar en önskad bredd specificerad med ett antal punkter.
override Equals(object)Avgör om det angivna objektet har samma värde som det aktuella objektet.
Equals(PreferredWidth)Avgör om den angivnaPreferredWidth är lika värdefullt som den nuvarandePreferredWidth .
override GetHashCode()Fungerar som en hashfunktion för den här typen.
override ToString()Returnerar en användarvänlig sträng som visar värdet för detta objekt.

Fält

namnBeskrivning
static readonly AutoReturnerar en instans som representerar värdet “föredragen bredd är inte angiven”.

Anmärkningar

Önskad bredd kan anges som en procentandel, antal punkter eller ett särskilt värde för “ingen/auto”.

Instanserna av den här klassen är oföränderliga.

Exempel

Visar hur man ställer in en tabell så att den automatiskt anpassas 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 anger en önskad 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 - Ange en absolut önskad 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 - Ange en relativ önskad bredd baserat på procentandel 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 specificerad ö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

CellVerticalAlignment Enum PreferredWidthType Enum