PreferredWidth

PreferredWidth class

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

Per saperne di più, visita ilLavorare con le tabelle articolo di documentazione.

public sealed class PreferredWidth

Proprietà

NomeDescrizione
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 nelType proprietà.

Metodi

NomeDescrizione
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 ha un valore uguale all’oggetto corrente.
Equals(PreferredWidth)Determina se specificatoPreferredWidth ha lo stesso valore della correntePreferredWidth .
override GetHashCode()Serve come funzione hash per questo tipo.
override ToString()Restituisce una stringa intuitiva che visualizza il valore di questo oggetto.

Campi

NomeDescrizione
static readonly AutoRestituisce un’istanza che rappresenta il valore “larghezza preferita non specificata”.

Osservazioni

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

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 la 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 preferita relativa 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 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

CellVerticalAlignment Enum PreferredWidthType Enum