CellFormat

CellFormat class

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

Pour en savoir plus, visitez leTravailler avec des tableaux article documentaire.

public class CellFormat

Propriétés

NomLa 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; }Sivrai , 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 unShading objet qui fait référence au formatage d’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; }Sivrai , enveloppe le texte de la cellule.

Méthodes

NomLa description
ClearFormatting()Réinitialise le formatage de cellule par défaut. Ne modifie 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 le formatage 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 dans 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 le formatage 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 documents
// 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 le formatage l'appliquera à la cellule actuelle,
// et toutes les nouvelles cellules que nous créons ensuite avec le constructeur.
// 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 la ligne pour l'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

CellCollection Class CellMerge Enum