ConditionalStyle

ConditionalStyle class

Représente une mise en forme spéciale appliquée à certaines zones d’un tableau avec un style de tableau attribué.

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

public sealed class ConditionalStyle

Propriétés

NomLa description
Borders { get; }Obtient la collection de bordures de cellules par défaut pour le style conditionnel.
BottomPadding { get; set; }Obtient ou définit la quantité d’espace (en points) à ajouter sous le contenu des cellules du tableau.
Font { get; }Obtient le formatage des caractères du style conditionnel.
LeftPadding { get; set; }Obtient ou définit la quantité d’espace (en points) à ajouter à gauche du contenu des cellules du tableau.
ParagraphFormat { get; }Obtient la mise en forme du paragraphe du style conditionnel.
RightPadding { get; set; }Obtient ou définit la quantité d’espace (en points) à ajouter à droite du contenu des cellules du tableau.
Shading { get; }Obtient unShading objet qui fait référence au formatage d’ombrage pour ce style conditionnel.
TopPadding { get; set; }Obtient ou définit la quantité d’espace (en points) à ajouter au-dessus du contenu des cellules du tableau.
Type { get; }Obtient la zone de tableau à laquelle ce style conditionnel se rapporte.

Méthodes

NomLa description
ClearFormatting()Efface le formatage de ce style conditionnel.
override Equals(object)Compare ce style conditionnel avec l’objet spécifié.
override GetHashCode()Calcule le code de hachage pour cet objet.

Exemples

Montre comment travailler avec certains styles de zones d’un tableau.

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell 1");
builder.InsertCell();
builder.Write("Cell 2");
builder.EndRow();
builder.InsertCell();
builder.Write("Cell 3");
builder.InsertCell();
builder.Write("Cell 4");
builder.EndTable();

// Crée un style de tableau personnalisé.
TableStyle tableStyle = (TableStyle)doc.Styles.Add(StyleType.Table, "MyTableStyle1");

// Les styles conditionnels sont des modifications de formatage qui n'affectent que certaines cellules du tableau
// basé sur un prédicat, tel que les cellules de la dernière ligne.
// Vous trouverez ci-dessous trois manières d'accéder aux styles conditionnels d'un style de tableau à partir de la collection "ConditionalStyles".
// 1 - Par type de style :
tableStyle.ConditionalStyles[ConditionalStyleType.FirstRow].Shading.BackgroundPatternColor = Color.AliceBlue;

// 2 - Par index :
tableStyle.ConditionalStyles[0].Borders.Color = Color.Black;
tableStyle.ConditionalStyles[0].Borders.LineStyle = LineStyle.DotDash;
Assert.AreEqual(ConditionalStyleType.FirstRow, tableStyle.ConditionalStyles[0].Type);

// 3 - En propriété :
tableStyle.ConditionalStyles.FirstRow.ParagraphFormat.Alignment = ParagraphAlignment.Center;

// Applique un remplissage et un formatage de texte aux styles conditionnels.
tableStyle.ConditionalStyles.LastRow.BottomPadding = 10;
tableStyle.ConditionalStyles.LastRow.LeftPadding = 10;
tableStyle.ConditionalStyles.LastRow.RightPadding = 10;
tableStyle.ConditionalStyles.LastRow.TopPadding = 10;
tableStyle.ConditionalStyles.LastColumn.Font.Bold = true;

// Liste toutes les conditions de style possibles.
using (IEnumerator<ConditionalStyle> enumerator = tableStyle.ConditionalStyles.GetEnumerator())
{
    while (enumerator.MoveNext())
    {
        ConditionalStyle currentStyle = enumerator.Current;
        if (currentStyle != null) Console.WriteLine(currentStyle.Type);
    }
}

// Applique le style personnalisé, qui contient tous les styles conditionnels, au tableau.
table.Style = tableStyle;

// Notre style applique certains styles conditionnels par défaut.
Assert.AreEqual(TableStyleOptions.FirstRow | TableStyleOptions.FirstColumn | TableStyleOptions.RowBands, 
    table.StyleOptions);

// Nous devrons activer nous-mêmes tous les autres styles via la propriété "StyleOptions".
table.StyleOptions = table.StyleOptions | TableStyleOptions.LastRow | TableStyleOptions.LastColumn;

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

Voir également

CompositeNode Class ConditionalStyleCollection Class