CellFormat

CellFormat class

Représente toute la mise en forme d’une cellule de tableau.

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

public class CellFormat

Propriétés

NomLa description
Borders { get; }Obtient la collection des 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.
HideMark { get; set; }Renvoie ou définit la visibilité de la marque de 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 à 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 avec d’autres cellules verticalement.
Width { get; set; }Obtient la largeur de la cellule en points.
WrapText { get; set; }Sivrai , envelopper le texte pour la cellule.

Méthodes

NomLa description
ClearFormatting()Rétablit la mise en forme par défaut de la cellule. 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 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 la mise en forme 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();

// Utilisez 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 documents
// les appliquera à chaque ligne et cellule que nous ajouterons avec lui.
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();

// La modification de la mise en forme l'appliquera à la cellule actuelle,
// et toutes les nouvelles cellules que nous créons avec le générateur 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();

// Augmenter la hauteur de la 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

CellCollection Class CellMerge Enum