PreferredWidth

CellFormat.PreferredWidth property

Renvoie ou définit la largeur préférée de la cellule.

public PreferredWidth PreferredWidth { get; set; }

Remarques

La largeur préférée (ainsi que l’option Ajustement automatique du tableau) détermine la façon dont la largeur réelle de la cellule est calculée par l’algorithme de mise en page du tableau. La mise en page du tableau peut être effectuée par Aspose.Words lorsqu’il enregistre le document ou par Microsoft Word lorsqu’il affiche le document.

La largeur préférée peut être spécifiée en points ou en pourcentage. La largeur préférée peut également être spécifiée comme “auto”, ce qui signifie qu’aucune largeur préférée n’est spécifiée.

La valeur par défaut estAuto.

Exemples

Montre comment définir une largeur préférée pour les cellules de tableau.

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

// Il existe deux manières d'appliquer la classe "PreferredWidth" aux cellules d'un tableau.
// 1 - Définissez une largeur préférée absolue basée sur les points :
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 - Définissez une largeur préférée relative basée sur le pourcentage de la largeur du tableau :
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();

// Une cellule sans largeur préférée spécifiée occupera le reste de l'espace disponible.
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// Chaque configuration de la propriété "PreferredWidth" crée un nouvel objet.
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");

Voir également