Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ConditionalFormattingRule - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Règle de mise en forme conditionnelle. Lorsque l'objet est sérialisé en XML, son nom qualifié est x: cfRule.

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Spreadsheet.ConditionalFormattingRule

Espace de noms :  DocumentFormat.OpenXml.Spreadsheet
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(DataBar))]
[ChildElementInfoAttribute(typeof(ColorScale))]
[ChildElementInfoAttribute(typeof(IconSet))]
[ChildElementInfoAttribute(typeof(ConditionalFormattingRuleExtensionList))]
[ChildElementInfoAttribute(typeof(Formula))]
public class ConditionalFormattingRule : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

cfRule (règle de mise en forme conditionnelle)

Cette collection représente une description d’une règle de mise en forme conditionnelle.

[Exemple :

Cet exemple illustre une règle de mise en forme conditionnelle mise en surbrillance des cellules dont les valeurs sont supérieures à 0,5. Notez que dans ce cas le contenu de < formule > est une valeur statique, mais peut également être une expression de formule.

<conditionalFormatting sqref="E3:E9">
  <cfRule type="cellIs" dxfId="0" priority="1" operator="greaterThan">
    <formula>0.5</formula>
  </cfRule>
</conditionalFormatting>

Fin de l’exemple]

Seules les règles avec une valeur d'attribut type de l'expression prend en charge la syntaxe des formules.

Éléments parents

conditionalFormatting (§18.3.1.18)

Élements enfants

Sous-clause

colorScale (échelle de couleur)

§18.3.1.16

dataBar (barre de données)

§18.3.1.28

extLst (futur fonctionnalité de zone de stockage)

§18.2.10

formule (Formula)

§18.3.1.43

iconSet (jeu d'icônes)

§18.3.1.49

Attributs

Description

aboveAverage (au-dessus ou au-dessous de la moyenne)

Indique si la règle est une règle « au-dessus de la moyenne ». « 1 » indique « au-dessus de la moyenne ». Cet attribut est ignoré si le type n'est pas égal à aboveAverage.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

bas (bas N)

Indique si une règle « haut/bas n » est une règle « n bas ». « 1 » indique « bas ». Cet attribut est ignoré si le type n'est pas égal à top10.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

dxfId (Id de mise en forme différentielle)

Il s'agit de l'index d'un élément dxf dans la partie de Styles indiquant quelle cellule mise en forme à appliquer lorsque les critères de règle de mise en forme conditionnelle est remplie.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_DxfId (§18.18.25).

equalAverage (moyenne égale)

Indicateur précisant si les critères « aboveAverage » et « belowAverage » est compris la moyenne lui-même ou hors de cette valeur. « 1 » indique pour inclure la valeur moyenne dans les critères. Cet attribut est ignoré si le type n'est pas égal à aboveAverage.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

(opérateur)

L'opérateur dans une règle de mise en forme conditionnelle « valeur de la cellule est ». Cet attribut est ignoré si le type n'est pas égal à cellIs

Les valeurs possibles pour cet attribut sont définies par le type simple ST_ConditionalFormattingOperator (§18.18.15).

pour cent (10 premiers pour cent)

Indique si une règle « haut/bas n » est une règle « n pour cent de haut en bas ». Cet attribut est ignoré si le type n'est pas égal à top10.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

Priority (priorité)

La priorité de la règle de mise en forme conditionnelle. Cette valeur est utilisée pour déterminer quel format doit être évalué et rendu. Les valeurs numériques inférieures sont prioritaires sur les valeurs numériques sont supérieures, où « 1 » est la priorité la plus élevée.

Les valeurs possibles pour cet attribut sont définies par le type de données int W3C XML Schema.

rang (Rank)

La valeur de « n » dans une règle de mise en forme conditionnelle « n de haut en bas ». Cet attribut est ignoré si le type n'est pas égal à top10.

Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.

stdDev (StdDev)

Nombre d'écarts-types à inclure au-dessus ou en dessous de la moyenne dans la règle de mise en forme conditionnelle. Cet attribut est ignoré si le type n'est pas égal à aboveAverage. Si une valeur est présente pour stdDev et le type de règle = aboveAverage, cette règle est alors automatiquement une règle « au-dessus ou en dessous des écarts N ».

Les valeurs possibles pour cet attribut sont définies par le type de données int W3C XML Schema.

stopIfTrue (interrompre si vrai)

Si cet indicateur est « 1 », aucune règle de priorité inférieure n'est APPLIQUEE sur cette règle, lorsque cette règle est évaluée à true.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

texte (texte)

La valeur de texte dans une règle de mise en forme conditionnelle « texte contient ». Cet attribut est ignoré si le type n'est pas égal à containsText.

Les valeurs possibles pour cet attribut sont définies par le type de données chaîne W3C XML Schema.

timePeriod (période)

Le délai applicable dans une règle de mise en forme conditionnelle « date se produisant... ». Cet attribut est ignoré si le type n'est pas égal à timePeriod.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_TimePeriod (§18.18.82).

type (Type)

Type de règle de mise en forme conditionnelle.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_CfType (§18.18.12).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_CfRule) se trouve dans §A.2. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: