PreferredWidth

CellFormat.PreferredWidth property

Restituisce o imposta la larghezza preferita della cella.

public PreferredWidth PreferredWidth { get; set; }

Osservazioni

La larghezza preferita (insieme all’opzione Adattamento automatico della tabella) determina il modo in cui la larghezza effettiva della cella viene calcolata dall’algoritmo di layout della tabella. Il layout della tabella può essere eseguito da Aspose.Words quando salva il documento o da Microsoft Word quando visualizza il documento.

La larghezza preferita può essere specificata in punti o in percentuale. La larghezza preferita può anche essere specificata come “auto”, il che significa che non viene specificata alcuna larghezza preferita.

Il valore predefinito èAuto.

Esempi

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

CellFormat.Orientation CellFormat.RightPadding