Nouveautés de l’API JavaScript 1.6 pour Excel

  • Article

Mise en forme conditionnelle

Introduit la mise en forme conditionnelle d’une plage. Autorise les types suivants de mise en forme conditionnelle.

  • Échelle de couleurs
  • Barre de données
  • Jeu d'icônes
  • Personnalisé

De plus :

  • Renvoie la plage à laquelle s’applique la mise en forme conditionnelle.
  • Supprime la mise en forme conditionnelle.
  • Fournit la priorité et stopifTrue la fonctionnalité.
  • Obtient la collection de toutes les mises en forme conditionnelles sur une plage donnée.
  • Efface toutes les mises en forme conditionnelles actives sur la plage spécifiée actuelle.

Liste des API

Le tableau suivant répertorie les API dans l’ensemble de conditions requises de l’API JavaScript Excel 1.6. Pour afficher la documentation de référence des API pour toutes les API prises en charge par l’ensemble de conditions requises de l’API JavaScript Excel 1.6 ou version antérieure, consultez API Excel dans l’ensemble de conditions requises 1.6 ou antérieur.

Classe Champs Description
Application suspendApiCalculationUntilNextSync() Suspend le calcul jusqu’à ce que le suivant context.sync() soit appelé.
CellValueConditionalFormat format Renvoie un objet de format, encapsulant la police, le remplissage, les bordures et d’autres propriétés des formats conditionnels.
Règle Spécifie l’objet de règle sur ce format conditionnel.
ColorScaleConditionalFormat criteria Critères de l’échelle de couleurs.
threeColorScale Si truela valeur est , l’échelle de couleurs aura trois points (minimum, milieu, maximum), sinon elle en aura deux (minimum, maximum).
ConditionalCellValueRule formula1 Formule, si nécessaire, sur laquelle évaluer la règle de mise en forme conditionnelle.
formula2 Formule, si nécessaire, sur laquelle évaluer la règle de mise en forme conditionnelle.
opérateur Opérateur du format conditionnel de la valeur de cellule.
ConditionalColorScaleCriteria maximum Point maximal du critère d’échelle de couleurs.
Milieu Point milieu du critère d’échelle de couleurs, si l’échelle de couleurs est une échelle à 3 couleurs.
minimum Point minimal du critère d’échelle de couleurs.
ConditionalColorScaleCriterion color Représentation par code de couleur HTML de la couleur de l’échelle de couleurs (par exemple, #FF0000 représente le rouge).
formula Un nombre, une formule ou null (si type a la valeur lowestValue).
type Sur quoi la formule conditionnelle de critère doit être basée.
ConditionalDataBarNegativeFormat Bordercolor Code de couleur HTML représentant la couleur de la ligne de bordure, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
fillColor Code de couleur HTML représentant la couleur de remplissage, au format #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
matchPositiveBorderColor Spécifie si la barre de données négative a la même couleur de bordure que la barre de données positive.
matchPositiveFillColor Spécifie si la barre de données négative a la même couleur de remplissage que la barre de données positive.
ConditionalDataBarPositiveFormat Bordercolor Code de couleur HTML représentant la couleur de la ligne de bordure, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
fillColor Code de couleur HTML représentant la couleur de remplissage, au format #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
Gradientfill Spécifie si la barre de données a un dégradé.
ConditionalDataBarRule formula Formule, si nécessaire, sur laquelle évaluer la règle de barre de données.
type Type de règle pour la barre de données.
ConditionalFormat cellValue Retourne les propriétés de format conditionnel de la valeur de cellule si le format conditionnel actuel est un CellValue type.
cellValueOrNullObject Retourne les propriétés de format conditionnel de la valeur de cellule si le format conditionnel actuel est un CellValue type.
Colorscale Retourne les propriétés de format conditionnel de l’échelle de couleurs si le format conditionnel actuel est un ColorScale type.
colorScaleOrNullObject Retourne les propriétés de format conditionnel de l’échelle de couleurs si le format conditionnel actuel est un ColorScale type.
Personnalisé Retourne les propriétés de format conditionnel personnalisé si le format conditionnel actuel est un type personnalisé.
customOrNullObject Retourne les propriétés de format conditionnel personnalisé si le format conditionnel actuel est un type personnalisé.
Databar Retourne les propriétés de la barre de données si le format conditionnel actuel est une barre de données.
dataBarOrNullObject Retourne les propriétés de la barre de données si le format conditionnel actuel est une barre de données.
delete() Supprime cette mise en forme conditionnelle.
getRange() Renvoie la plage à laquelle s’applique la mise en forme conditionnelle.
getRangeOrNullObject() Retourne la plage à laquelle le format conditonal est appliqué.
Iconset Retourne les propriétés de mise en forme conditionnelle du jeu d’icônes si le format conditionnel actuel est un IconSet type.
iconSetOrNullObject Retourne les propriétés de mise en forme conditionnelle du jeu d’icônes si le format conditionnel actuel est un IconSet type.
id Priorité du format conditionnel dans le actuel ConditionalFormatCollection.
Préréglage Retourne le format conditionnel des critères prédéfinis.
presetOrNullObject Retourne le format conditionnel des critères prédéfinis.
Priorité Priorité (ou index) dans la collection de formats conditionnels dans laquelle ce format conditionnel existe actuellement.
stopIfTrue Si les conditions de cette mise en forme conditionnelle sont remplies, aucun format de priorité inférieure ne doit prendre effet sur cette cellule.
textComparison Retourne les propriétés de mise en forme conditionnelle de texte spécifiques si le format conditionnel actuel est un type de texte.
textComparisonOrNullObject Retourne les propriétés de mise en forme conditionnelle de texte spécifiques si le format conditionnel actuel est un type de texte.
topBottom Retourne les propriétés de format conditionnel haut/bas si le format conditionnel actuel est un TopBottom type.
topBottomOrNullObject Retourne les propriétés de format conditionnel haut/bas si le format conditionnel actuel est un TopBottom type.
type Type de format conditionnel.
ConditionalFormatCollection add(type : Excel.ConditionalFormatType) Ajoute un nouveau format conditionnel à la collection à la première/première priorité.
clearAll() Efface toutes les mises en forme conditionnelles actives sur la plage spécifiée actuelle.
getCount() Retourne le nombre de formats conditionnels dans le classeur.
getItem(id: string) Renvoie une mise en forme conditionnelle à un ID donné.
getItemAt(index: number) Renvoie une mise en forme conditionnelle à l’index donné.
items Obtient l’élément enfant chargé dans cette collection de sites.
ConditionalFormatRule formula Formule, si nécessaire, sur laquelle évaluer la règle de mise en forme conditionnelle.
formulaLocal Formule, si nécessaire, sur laquelle évaluer la règle de mise en forme conditionnelle dans la langue de l’utilisateur.
formulaR1C1 Formule, si nécessaire, sur laquelle évaluer la règle de format conditionnel en notation de style R1C1.
ConditionalIconCriterion customIcon L’icône personnalisée pour le critère actuel, si différente de l’ensemble d’icônes par défaut, est null retournée.
formula Un nombre ou une formule en fonction du type.
opérateur greaterThan ou greaterThanOrEqual pour chacun des types de règles pour le format conditionnel d’icône.
type Ce sur quoi la formule conditionnelle de l’icône doit être basée.
ConditionalPresetCriteriaRule Critère Critère du format conditionnel.
ConditionalRangeBorder color Code de couleur HTML représentant la couleur de la ligne de bordure, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
sideIndex Valeur constante qui indique un côté spécifique de la bordure.
style L’une des constantes de style de ligne déterminant le style de ligne de la bordure.
ConditionalRangeBorderCollection bas Obtient la bordure inférieure.
count Nombre d’objets de bordure de la collection.
getItem(index : Excel.ConditionalRangeBorderIndex) Obtient un objet de bordure à l’aide de son nom.
getItemAt(index: number) Obtient un objet de bordure à l’aide de son indice.
items Obtient l’élément enfant chargé dans cette collection de sites.
left Obtient la bordure gauche.
right Obtient la bordure droite.
top Obtient la bordure supérieure.
ConditionalRangeFill clear() Réinitialise le remplissage.
color Code de couleur HTML représentant la couleur du remplissage, dans le formulaire #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
ConditionalRangeFont bold Spécifie si la police est en gras.
clear() Réinitialise les formats de police.
color Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).
italic Spécifie si la police est en italique.
strikethrough Spécifie le status barré de la police.
underline Type de soulignement appliqué à la police.
ConditionalRangeFormat Borders Collection d’objets de bordure qui s’appliquent à la plage de format conditionnel globale.
fill Renvoie l’objet de remplissage défini sur la plage de format conditionnel globale.
police Retourne l’objet de police défini sur la plage de format conditionnel globale.
numberFormat Représente le code de format numérique d’Excel pour la plage donnée.
ConditionalTextComparisonRule opérateur Opérateur du format conditionnel de texte.
text Valeur de texte du format conditionnel.
ConditionalTopBottomRule rank Rang compris entre 1 et 1000 pour les rangs numériques ou entre 1 et 100 pour les rangs en pourcentage.
type Mettre en forme les valeurs en fonction du rang supérieur ou inférieur.
CustomConditionalFormat format Renvoie un objet de format, encapsulant la police, le remplissage, les bordures et d’autres propriétés des formats conditionnels.
Règle Spécifie l’objet Rule sur ce format conditionnel.
DataBarConditionalFormat axisColor Code de couleur HTML représentant la couleur de la ligne Axe, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).
axisFormat Représentation de la façon dont l’axe est déterminé pour une barre de données Excel.
barDirection Spécifie la direction sur laquelle le graphique de barre de données doit être basé.
lowerBoundRule Règle de ce qui constitue la limite inférieure (et comment la calculer, le cas échéant) pour une barre de données.
negativeFormat Représentation de toutes les valeurs à gauche de l’axe dans une barre de données Excel.
positiveFormat Représentation de toutes les valeurs à droite de l’axe dans une barre de données Excel.
showDataBarOnly Si truela valeur est , masque les valeurs des cellules dans lesquelles la barre de données est appliquée.
upperBoundRule Règle de ce qui constitue la limite supérieure (et comment la calculer, le cas échéant) pour une barre de données.
IconSetConditionalFormat criteria Tableau de critères et jeux d’icônes pour les règles et icônes personnalisées potentielles pour les icônes conditionnelles.
reverseIconOrder Si truela valeur est , inverse les ordres d’icônes pour le jeu d’icônes.
showIconOnly Si truela valeur est , masque les valeurs et affiche uniquement les icônes.
style Si cette option est définie, affiche l’option jeu d’icônes pour le format conditionnel.
PresetCriteriaConditionalFormat format Renvoie un objet de format, encapsulant la police, le remplissage, les bordures et d’autres propriétés des formats conditionnels.
Règle Règle de mise en forme conditionnelle.
Range calculate() Calcule une plage de cellules dans une feuille de calcul.
conditionalFormats Collection de ConditionalFormats qui croise la plage.
TextConditionalFormat format Renvoie un objet format, encapsulant la police, le remplissage, les bordures et d’autres propriétés du format conditionnel.
Règle Règle de mise en forme conditionnelle.
TopBottomConditionalFormat format Renvoie un objet format, encapsulant la police, le remplissage, les bordures et d’autres propriétés du format conditionnel.
Règle Critères du format conditionnel supérieur/inférieur.
Feuille de calcul calculate(markAllDirty : boolean) Calcule toutes les cellules d’une feuille de calcul.

Voir aussi