PreferredWidth

PreferredWidth class

Rappresenta un valore e la relativa unità di misura utilizzati per specificare la larghezza preferita di una tabella o di una cella.

public sealed class PreferredWidth

Proprietà

Nome Descrizione
Type { get; } Ottiene l’unità di misura utilizzata per questo valore di larghezza preferito.
Value { get; } Ottiene il valore di larghezza preferito. L’unità di misura è specificata nellaType proprietà.

Metodi

Nome Descrizione
static FromPercent(double) Un metodo di creazione che restituisce una nuova istanza che rappresenta una larghezza preferita specificata come percentuale.
static FromPoints(double) Un metodo di creazione che restituisce una nuova istanza che rappresenta una larghezza preferita specificata utilizzando un numero di punti.
override Equals(object) Determina se l’oggetto specificato è uguale in valore all’oggetto corrente.
Equals(PreferredWidth) Determina se il valore PreferredWidth specificato è uguale al valore PreferredWidth corrente.
override GetHashCode() Serve come funzione hash per questo tipo.
override ToString() Restituisce una stringa intuitiva che visualizza il valore di questo oggetto.

Campi

Nome Descrizione
static readonly Auto Restituisce un’istanza che rappresenta il valore “la larghezza preferita non è specificata”.

Osservazioni

La larghezza preferita può essere specificata come percentuale, numero di punti o un valore speciale “nessuno/auto”.

Le istanze di questa classe sono immutabili.

Esempi

Mostra come impostare una tabella in modo che si adatti automaticamente al 50% della larghezza della pagina.

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

Mostra come impostare una larghezza preferita per le celle della tabella.

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

// Esistono due modi per applicare la classe "PreferredWidth" alle celle della tabella.
// 1 - Imposta una larghezza preferita assoluta in base ai punti:
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 - Imposta una larghezza relativa preferita in base alla percentuale della larghezza della tabella:
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();

// Una cella senza una larghezza preferita specificata occuperà il resto dello spazio disponibile.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// Ogni configurazione della proprietà "PreferredWidth" crea un nuovo oggetto.
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");

Guarda anche