CellFormat

CellFormat class

Représente tout le formatage d’une cellule de tableau.

public class CellFormat

Propriétés

Nom La description
Borders { get; } Obtient la collection de bordures de la cellule.
BottomPadding { get; set; } Renvoie ou définit la quantité d’espace (en points) à ajouter sous le contenu de la cellule.
FitText { get; set; } Si vrai, ajuste le texte dans la cellule, en compressant chaque paragraphe à la largeur de la cellule.
HorizontalMerge { get; set; } Spécifie comment la cellule est fusionnée horizontalement avec les autres cellules de la ligne.
LeftPadding { get; set; } Renvoie ou définit la quantité d’espace (en points) à ajouter à gauche du contenu de la cellule.
Orientation { get; set; } Renvoie ou définit l’orientation du texte dans une cellule de tableau.
PreferredWidth { get; set; } Renvoie ou définit la largeur préférée de la cellule.
RightPadding { get; set; } Renvoie ou définit la quantité d’espace (en points) à ajouter à droite du contenu de la cellule.
Shading { get; } Renvoie un objet Shading qui fait référence à la mise en forme de l’ombrage de la cellule.
TopPadding { get; set; } Renvoie ou définit la quantité d’espace (en points) à ajouter au-dessus du contenu de la cellule.
VerticalAlignment { get; set; } Renvoie ou définit l’alignement vertical du texte dans la cellule.
VerticalMerge { get; set; } Spécifie comment la cellule est fusionnée verticalement avec d’autres cellules.
Width { get; set; } Obtient la largeur de la cellule en points.
WrapText { get; set; } Si vrai, envelopper le texte pour la cellule.

Méthodes

Nom La description
ClearFormatting() Réinitialise le formatage de cellule par défaut. Ne change pas la largeur de la cellule.
SetPaddings(double, double, double, double) Définit la quantité d’espace (en points) à ajouter à gauche/en haut/à droite/en bas du contenu de la cellule.

Exemples

Montre comment modifier la mise en forme d’une cellule de tableau.

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// Utilisez la propriété "CellFormat" d'une cellule pour définir le formatage qui modifie l'apparence de cette cellule.
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

doc.Save(ArtifactsDir + "Table.CellFormat.docx");

Montre comment modifier le format des lignes et des cellules d’un tableau.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// Utiliser la propriété "RowFormat" de la première ligne pour modifier la mise en forme
// du contenu de toutes les cellules de cette ligne.
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// Utilisez la propriété "CellFormat" de la première cellule de la dernière ligne pour modifier la mise en forme du contenu de cette cellule.
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

doc.Save(ArtifactsDir + "Table.RowCellFormat.docx");

Montre comment créer un tableau avec des bordures personnalisées.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();

// Définition des options de formatage de tableau pour un générateur de document
// les appliquera à chaque ligne et cellule que nous ajouterons avec.
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// Changer la mise en forme l'appliquera à la cellule courante,
// et toutes les nouvelles cellules que nous créons avec le constructeur par la suite.
// Cela n'affectera pas les cellules que nous avons ajoutées précédemment.
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// Augmente la hauteur de ligne pour s'adapter au texte vertical.
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTable.docx");

Voir également