ConditionalStyle

ConditionalStyle class

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

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

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 la mise en forme 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 à la mise en forme 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 table à laquelle ce style conditionnel se rapporte.

Méthodes

NomLa description
ClearFormatting()Efface la mise en forme 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 zone 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éer un style de tableau personnalisé.
TableStyle tableStyle = (TableStyle)doc.Styles.Add(StyleType.Table, "MyTableStyle1");

// Les styles conditionnels sont des modifications de formatage qui affectent uniquement certaines cellules du tableau
// basé sur un prédicat, tel que les cellules se trouvant dans 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 tant que propriété :
tableStyle.ConditionalStyles.FirstRow.ParagraphFormat.Alignment = ParagraphAlignment.Center;

// Appliquer le remplissage et la mise en forme du 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;

// Répertoriez 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);
    }
}

// Appliquez 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 tous les autres styles nous-mêmes via la propriété « StyleOptions ».
table.StyleOptions = table.StyleOptions | TableStyleOptions.LastRow | TableStyleOptions.LastColumn;

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

Voir également