ExcelScript.ConditionalDataBarNegativeFormat interface

Paquet:

ExcelScript

Représente un format conditionnel pour le côté négatif de la barre de données.

Remarques

Exemples

/**
 * This script applies data bar conditional formatting to a range.
 * It sets the data bar colors to be green when positive and red when negative.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the "Sales" data column range in a table named "SalesTable".
    const table = workbook.getTable("SalesTable");
    const salesRange = table.getColumnByName("Sales").getRangeBetweenHeaderAndTotal();

    // Add data bar conditional formatting to the range.
    const cf = salesRange.addConditionalFormat(ExcelScript.ConditionalFormatType.dataBar);

    // Have the bar show green when positive and red when negative. 
    const dataBarConditionalFormat = cf.getDataBar();
    const positiveFormat: ExcelScript.ConditionalDataBarPositiveFormat = dataBarConditionalFormat.getPositiveFormat();
    positiveFormat .setFillColor("green");
    const negativeFormat: ExcelScript.ConditionalDataBarNegativeFormat = dataBarConditionalFormat.getNegativeFormat();
    negativeFormat.setFillColor("red");
}

Méthodes

getBorderColor()	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 »). La valeur est « » (chaîne vide) si aucune bordure n’est présente ou définie.
getFillColor()	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 »).
getMatchPositiveBorderColor()	Spécifie si la barre de données négative a la même couleur de bordure que la barre de données positive.
getMatchPositiveFillColor()	Spécifie si la barre de données négative a la même couleur de remplissage que la barre de données positive.
setBorderColor(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 »). La valeur est « » (chaîne vide) si aucune bordure n’est présente ou définie.
setFillColor(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 »).
setMatchPositiveBorderColor(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.
setMatchPositiveFillColor(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.

Détails de la méthode

getBorderColor()

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 »). La valeur est « » (chaîne vide) si aucune bordure n’est présente ou définie.

getBorderColor(): string;

Retours

string

getFillColor()

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 »).

getFillColor(): string;

Retours

string

getMatchPositiveBorderColor()

Spécifie si la barre de données négative a la même couleur de bordure que la barre de données positive.

getMatchPositiveBorderColor(): boolean;

Retours

boolean

getMatchPositiveFillColor()

Spécifie si la barre de données négative a la même couleur de remplissage que la barre de données positive.

getMatchPositiveFillColor(): boolean;

Retours

boolean

setBorderColor(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 »). La valeur est « » (chaîne vide) si aucune bordure n’est présente ou définie.

setBorderColor(borderColor: string): void;

Paramètres

borderColor

string

Retours

void

setFillColor(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 »).

setFillColor(fillColor: string): void;

Paramètres

fillColor

string

Retours

void

setMatchPositiveBorderColor(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.

setMatchPositiveBorderColor(matchPositiveBorderColor: boolean): void;

Paramètres

matchPositiveBorderColor

boolean

Retours

void

setMatchPositiveFillColor(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.

setMatchPositiveFillColor(matchPositiveFillColor: boolean): void;

Paramètres

matchPositiveFillColor

boolean

Retours

void