Classe FormatCondition (Excel VBA)

Cet objet représente une mise en forme conditionnelle.

Les procédures principales de la classe FormatCondition sont Delete, FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddColorScale, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition, FormatConditions.AddTop10, FormatConditions.AddUniqueValues et FormatConditions.Delete

Set

Pour utiliser une variable de classe FormatCondition, elle doit d'abord être instanciée, par exemple

Dim fcd as FormatCondition
Set fcd = ActiveCell.FormatConditions(Index:=1)

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe FormatCondition : FormatConditions.Item, FormatConditions.Item, FormatConditions.Item, FormatConditions.Item, FormatConditions.Item, FormatConditions.Item, FormatConditions.Item, FormatConditions.Add, FormatConditions.Add, FormatConditions.Add, FormatConditions.Add, FormatConditions.Add, FormatConditions.Add, FormatConditions.Add et Range.FormatConditions

For Each

Voici un exemple de traitement des éléments FormatCondition dans une collection

Dim fcd As FormatCondition
For Each fcd In ActiveCell.FormatConditions
	
Next fcd

Thèmes

Certaines procédures de cette classe ont été regroupées en thèmes et sont décrites sur des pages thématiques séparées

Formula with its procedures Formula1 et Formula2
Add with its procedures FormatConditions.Add, FormatConditions.AddAboveAverage, FormatConditions.AddDatabar, FormatConditions.AddIconSetCondition et FormatConditions.AddTop10

Méthodes

Les méthodes principales de la classe FormatCondition sont

Delete - Cette méthode supprime l'objet.

ActiveCell.FormatConditions(1).Delete

FormatConditions.AddColorScale - Cette méthode renvoie un nouvel objet ColorScale qui représente une règle de mise en forme conditionnelle qui utilise des dégradés dans les couleurs des cellules pour indiquer les différences relatives entre les valeurs des cellules incluses dans une plage sélectionnée.

Dim lngColorScaleType As Long: lngColorScaleType = 
Dim cseAddColorScale As ColorScale
Set cseAddColorScale = ActiveCell.FormatConditions.AddColorScale(ColorScaleType:=lngColorScaleType)

FormatConditions.AddUniqueValues - Renvoie un nouvel objet UniqueValues qui représente une règle de mise en forme conditionnelle pour la plage spécifiée.

Dim uvsAddUniqueValues As UniqueValues
Set uvsAddUniqueValues = ActiveCell.FormatConditions.AddUniqueValues()

FormatConditions.Delete - Cette méthode supprime l'objet.

ActiveCell.FormatConditions.Delete

Autre Méthodes

Modify - Cette méthode modifie un format conditionnel existant.

ModifyAppliesToRange - Définit la plage de cellules à laquelle cette règle de mise en forme s’applique.

SetFirstPriority - Affecte la valeur 1 à la priorité de cette règle de mise en forme conditionnelle afin qu’elle soit évaluée avant toutes les autres règles de la feuille de calcul.

SetLastPriority - Définit l’ordre d’évaluation de cette règle de mise en forme conditionnelle de sorte qu’elle soit évaluée après toutes les autres règles de la feuille de calcul.

FormatConditions.Item - Cette méthode renvoie un seul objet d'une collection.

Propriétés

AppliesTo Renvoie un objet Range qui spécifie la plage de cellules à laquelle la règle de mise en forme est appliquée.

Dim rngAppliesTo As Range
Set rngAppliesTo = ActiveCell.FormatConditions(1).AppliesTo

Borders Renvoie une collection Borders qui représente les bordures d'un style ou d'une plage de cellules (y compris une plage définie dans le cadre d'un format conditionnel).

Dim brdsBorders As Borders
Set brdsBorders = ActiveCell.FormatConditions(1).Borders

DateOperator Spécifie l’opérateur Date utilisé dans le format conditionnel. Lecture-écriture.

ActiveCell.FormatConditions(1).DateOperator = xlLast7Days

Font Renvoie un objet font qui représente la police de l'objet spécifié.

Dim fntFont As Font
Set fntFont = ActiveCell.FormatConditions(1).Font

Interior Renvoie un objet Interior qui représente l’intérieur de l’objet spécifié.

Dim intInterior As Interior
Set intInterior = ActiveCell.FormatConditions(1).Interior

NumberFormat Renvoie ou définit le format numérique appliqué à une cellule si la règle de mise en forme conditionnelle renvoie True. Variant en lecture/écriture.

ActiveCell.FormatConditions(1).NumberFormat =

Operator Cette propriété renvoie une valeur de type Long qui représente l'opérateur pour le format conditionnel.

Dim lngOperator As Long
lngOperator = ActiveCell.FormatConditions(1).Operator

Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions(1).Parent

Priority Renvoie ou définit la valeur de priorité de la règle de mise en forme conditionnelle. La priorité détermine l’ordre d’évaluation lorsque plusieurs règles de mise en forme conditionnelle existent dans une feuille de calcul.

ActiveCell.FormatConditions(1).Priority =

PTCondition Renvoie une valeur de type Boolean indiquant si le format conditionnel est appliqué à un tableau croisé dynamique. En lecture seule.

Dim booPTCondition As Boolean
booPTCondition = ActiveCell.FormatConditions(1).PTCondition

ScopeType Cette propriété renvoie ou définit l'une des constantes de l'énumération XlPivotConditionScope , qui détermine l'étendue du format conditionnel lorsqu'il est appliqué à un tableau croisé dynamique.

ActiveCell.FormatConditions(1).ScopeType = xlDataFieldScope

StopIfTrue Renvoie ou définit une valeur de type Boolean qui détermine si les autres règles de mise en forme conditionnelle de la cellule doivent être évaluées lorsque la règle active renvoie la valeur True.

ActiveCell.FormatConditions(1).StopIfTrue = True

Text Renvoie ou définit une valeur de type String qui spécifie la chaîne de texte utilisée par la règle de mise en forme conditionnelle.

ActiveCell.FormatConditions(1).Text =

TextOperator Cette propriété renvoie ou définit l'une des constantes de l'énumération XlContainsOperator , spécifiant la recherche de texte effectuée par la règle de mise en forme conditionnelle.

ActiveCell.FormatConditions(1).TextOperator = xlBeginsWith

Type Renvoie une valeur de type long , contenant une valeur XlFormatConditionType qui représente le type d'objet.

Dim xlfcType As XlFormatConditionType
xlfcType = ActiveCell.FormatConditions(1).Type

FormatConditions.Count Cette propriété renvoie une valeur de type Long qui représente le nombre d’objets de la collection.

Dim lngCount As Long
lngCount = ActiveCell.FormatConditions.Count

FormatConditions.Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveCell.FormatConditions.Parent