Partager via

Utilisation de la mise en forme conditionnelle

  • Article

Cette rubrique décrit la classe ConditionalFormatting du Kit de développement logiciel (SDK) Open XML et sa relation avec le schéma SpreadsheetML au format de fichier Open XML. Pour plus d’informations sur la structure globale des parties et des éléments qui composent un document SpreadsheetML, consultez Structure d’un document SpreadsheetML**.

Mise en forme conditionnelle en SpreadsheetML

La mise en forme conditionnelle des cellules permet de structurer les données dans une feuille de calcul. L'affichage de couleurs (en plus de l'affichage d'une valeur) permet de distinguer la grandeur relative de ces valeurs. Il existe plusieurs options de mise en forme que vous pouvez appliquer aux cellules en fonction de leur valeur. Vous pouvez mettre en surbrillance les premiers ou les derniers éléments, fournir des barres de données pour présenter une interface utilisateur à base de barres de progression, ou utiliser des échelles de couleurs pour indiquer les valeurs les plus élevées et les moins élevées. Vous pouvez appliquer directement la mise en forme conditionnelle à une cellule d'une feuille de calcul. La valeur ne doit pas forcément faire partie d'un tableau.

Tous les paramètres de mise en forme conditionnelle sont stockés au niveau de la feuille de calcul. La feuille de calcul stocke un < élément conditionalFormatting> pour chaque format appliqué à une cellule ou à une série de cellules. L'ensemble des cellules auxquelles le format s'applique est défini à l'aide de l'attribut sqref. L'attribut sqref spécifie une plage de cellules à l'aide de la notation « de:à », par exemple « A1:A10 ».

Le tableau suivant répertorie les classes courantes du Kit de développement logiciel (SDK) Open XML utilisées lors de l’utilisation de la classe ConditionalFormatting .

Élément SpreadsheetML Classe du Kit de développement logiciel (SDK) Open XML
cfRule Conditionalformattingrule
Databar Databar
Colorscale Colorscale
Iconset IconSet

Classe de mise en forme conditionnelle du Kit de développement logiciel (SDK) Open XML

La classeConditionalFormatting du Kit de développement logiciel (SDK) Open XML représente l’élément table (<conditionalFormatting>) défini dans le schéma de format de fichier Open XML pour les documents SpreadsheetML. Utilisez la classe ConditionalFormatting pour manipuler des éléments conditionalFormatting> individuels < dans un document SpreadsheetML.

Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément ConditionalFormatting (<conditionalFormatting>).

Un format conditionnel est un format (ombrage de cellule ou couleur de police, par exemple), qu'un tableur peut appliquer automatiquement à des cellules si une condition spécifique est vraie. Cette collection exprime des règles de mise en forme conditionnelle qui s'appliquent à une cellule ou une plage particulière.

Exemple : cet exemple applique une règle « top10 » aux cellules C3 :C8. Fait @dxfId référence à la mise en forme (définie dans la partie styles) à appliquer aux cellules qui correspondent aux critères.

    <conditionalFormatting sqref="C3:C8">
        <cfRule type="top10" dxfId="1" priority="3" rank="2"/>
    </conditionalFormatting>

© ISO/IEC29500: 2008.

Classe ConditionalFormattingRule

Les informations suivantes de la spécification ISO/IEC 29500 introduisent l’élément ConditionalFormattingRule (<cfRule>).

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 qui met en surbrillance les cellules dont les valeurs sont supérieures à 0,5. Notez que dans ce cas, le contenu de la <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>

Seules les règles dont la valeur d'attribut de type est une expression prennent en charge la syntaxe de formule.

© ISO/IEC29500: 2008.

Chaque format conditionnel est autorisé à spécifier diverses règles de mise en forme. Par exemple, vous pouvez appliquer en même temps une mise en forme relative à l'échelle de couleurs et aux barres de données. Chaque format conditionnel est représenté à l’aide d’un élément cfRule> distinct<. Pour spécifier la priorité d'affichage dans l'interface utilisateur, vous pouvez utiliser l'attribut priority. Étant donné qu’un < élément conditionalFormatting> peut chevaucher d’autres zones mises en forme de la feuille de calcul, la priorité est globale pour tous les formats conditionnels définis pour cette feuille de calcul.

L’élément <cfRule> a de nombreux types de mise en forme, tels que cellIs et top10, qui peuvent être appliqués. Chaque type de mise en forme utilise des éléments communs pour définir ses paramètres. Pour plus d’informations sur les attributs des règles de mise en forme conditionnelle, voir la spécification ISO/IEC 29500.

Classe DataBar

Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément DataBar (<dataBar>).

Décrit une règle de mise en forme conditionnelle de barre de données.

Exemple :

Dans cet exemple, un format conditionnel de barre de données est exprimé. Il s'applique à l'ensemble des valeurs des cellules de la plage de cellules, dont la couleur est bleue.

    <dataBar>
        <cfvo type="min" val="0"/>
        <cfvo type="max" val="0"/>
        <color rgb="FF638EC6"/>
    </dataBar>

La longueur de la barre de données d'une cellule peut être calculée comme suit :

Longueur de barre de données = minLength + (valeur de cellule - valeur minimale de la plage) / (valeur maximale de la plage - valeur minimale de la plage) * (maxLength - minLength),

où minLength et maxLength représentent un pourcentage fixe de la largeur de colonne (par défaut, 10 % et 90 % respectivement.)

La différence de longueur minimale (ou valeur d'incrémentation) est de 1 pixel.

© ISO/IEC29500: 2008.

Les barres de données utilisent une seule couleur et l'affichent sous forme de barre. La longueur de la barre indique la hauteur relative de la valeur de la cellule. Une barre de données utilise un modèle distinct dans la règle de mise en forme conditionnelle pour définir ses paramètres. L’élément <dataBar> stocke toutes les données pertinentes. Une barre de données requiert trois paramètres : les valeurs minimales et maximales à comparer aux valeurs des cellules, et une couleur. Le premier < élément cfvo>, ou objet de valeur de format conditionnel, définit la valeur minimale, le deuxième < élément cfvo> définit la valeur maximale. Vous pouvez utiliser différentes méthodes pour spécifier une valeur, par exemple à l'aide d'une formule ou d'une valeur codée en dur. Il existe une autre option usuelle qui consiste à utiliser les types « min » et « max ». Ces < types d’éléments cfvo> spécifient les valeurs minimales et maximales trouvées dans la plage de cellules auxquelles le format est appliqué. Cela permet d'obtenir une gradation précise entre les éléments les moins importants et les plus importants. En outre, vous pouvez spécifier la couleur de la barre de données à l’aide de l’élément <color> .

Classe ColorScale

Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément ColorScale (<colorScale>).

Décrit une gradation d'échelle de couleurs dans cette règle de mise en forme conditionnelle.

Exemple :

    <colorScale>
        <cfvo type="min" val="0"/>
        <cfvo type="max" val="0"/>
        <color theme="5"/>
        <color rgb="FFFFEF9C"/>
    </colorScale>

© ISO/IEC29500: 2008.

Les échelles de couleurs fournissent un affichage qui indique la valeur relative existant entre tous les éléments de cellule, comme pour une barre de données. Une échelle de couleurs utilise un modèle distinct dans la règle de mise en forme conditionnelle pour définir ses paramètres. Vous pouvez spécifier jusqu’à trois < valeurs d’élément cfvo> ou objet de valeur de format conditionnel : une pour le début de l’échelle, une pour le milieu de l’échelle et une pour la fin de l’échelle. La valeur intermédiaire est facultative. En outre, vous pouvez spécifier la couleur de l’échelle de couleurs à l’aide de l’élément <de couleur> .

Classe IconSet

Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément IconSet (<iconSet>).

Décrit une règle de mise en forme conditionnelle de jeu d'icônes.

Exemple : cet exemple illustre le style « 3Arrows » des icônes. La première icône du jeu doit être affichée si la valeur de la cellule est inférieure au 33e centile. La deuxième icône du jeu doit être affichée si la valeur de la cellule est inférieure au 67e centile et supérieure ou égale au 33e centile. La troisième icône du jeu doit être affichée si la valeur de la cellule est supérieure ou égale au 67e centile.

    <iconSet iconSet="3Arrows">
        <cfvo type="percentile" val="0"/>
        <cfvo type="percentile" val="33"/>
        <cfvo type="percentile" val="67"/>
    </iconSet>

© ISO/IEC29500: 2008.

À l'aide des jeux d'icônes, vous pouvez appliquer différents jeux d'icônes aux cellules qui contiennent vos données. Le jeu d'icônes utilise une plage de valeurs pour identifier les ensembles de cellules auxquels appliquer la règle de mise en forme. Le premier < élément cfvo> identifie la valeur la plus basse de la plage, le deuxième < élément cfvo>identifie le point central et le troisième < élément cfvo> identifie la valeur la plus élevée. Un jeu d'icônes identifie les icônes à appliquer aux cellules. Vous pouvez choisir diverses icônes codées en dur. Pour plus d'informations sur les icônes disponibles, voir la spécification ISO/IEC 29500.