FormatConditionCollection

FormatConditionCollection class

Représente la mise en forme conditionnelle. Les FormatConditions peuvent contenir jusqu’à trois formats conditionnels.

public class FormatConditionCollection

Propriétés

NomLa description
Count { get; }Obtient le nombre de conditions.
Item { get; }Obtient la condition de formatage par index.
RangeCount { get; }Obtient le nombre de plages formatées de manière conditionnelle.

Méthodes

NomLa description
Add(CellArea, FormatConditionType, OperatorType, string, string)Ajoute une condition de formatage et une plage de cellules affectées aux FormatConditions Les FormatConditions peuvent contenir jusqu’à trois formats conditionnels. Les références aux autres feuilles ne sont pas autorisées dans les formules de formatage conditionnel.
AddArea(CellArea)Ajoute une plage de cellules au format conditionnel.
AddCondition(FormatConditionType)Ajouter une condition de format.
AddCondition(FormatConditionType, OperatorType, string, string)Ajoute une condition de formatage.
GetCellArea(int)Obtient la plage de cellules mise en forme conditionnelle par index.
RemoveArea(int)Supprime la plage de cellules mise en forme conditionnelle par index.
RemoveArea(int, int, int, int)Supprimer la mise en forme conditionnelle dans la plage.
RemoveCondition(int)Supprime la condition de formatage par index.

Exemples


[C#]

//Créer un nouveau classeur.
Workbook workbook = new Workbook();

// Récupère la première feuille de calcul.
Worksheet sheet = workbook.Worksheets[0];

//Ajoute une mise en forme conditionnelle vide
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
// Définit la plage de format conditionnel.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
//Ajoute une condition.
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
//Ajoute une condition.
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
// Définit la couleur d'arrière-plan.
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
//Enregistrement du fichier Excel
workbook.Save("output.xls");   

[Visual Basic]

'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
' Ajoute une mise en forme conditionnelle vide
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
'Définit la plage de format conditionnel.
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
'Ajoute un état.
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
'Ajoute un état.
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
'Définit la couleur d'arrière-plan.
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
'Enregistrement du fichier Excel
workbook.Save("output.xls")

Voir également