ExcelScript.ConditionalDataBarNegativeFormat interface

Paket:

ExcelScript

Stellt ein bedingtes Format für die negative Seite des Datenbalkens dar.

Hinweise

Beispiele

/**
 * 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");
}

Methoden

getBorderColor()	HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt. Der Wert ist "" (eine leere Zeichenfolge), wenn kein Rahmen vorhanden oder festgelegt ist.
getFillColor()	HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
getMatchPositiveBorderColor()	Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe wie der positive Datenbalken aufweist.
getMatchPositiveFillColor()	Gibt an, ob der negative Datenbalken dieselbe Füllfarbe wie der positive Datenbalken aufweist.
setBorderColor(borderColor)	HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt. Der Wert ist "" (eine leere Zeichenfolge), wenn kein Rahmen vorhanden oder festgelegt ist.
setFillColor(fillColor)	HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.
setMatchPositiveBorderColor(matchPositiveBorderColor)	Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe wie der positive Datenbalken aufweist.
setMatchPositiveFillColor(matchPositiveFillColor)	Gibt an, ob der negative Datenbalken dieselbe Füllfarbe wie der positive Datenbalken aufweist.

Details zur Methode

getBorderColor()

HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt. Der Wert ist "" (eine leere Zeichenfolge), wenn kein Rahmen vorhanden oder festgelegt ist.

getBorderColor(): string;

Gibt zurück

string

getFillColor()

HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.

getFillColor(): string;

Gibt zurück

string

getMatchPositiveBorderColor()

Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe wie der positive Datenbalken aufweist.

getMatchPositiveBorderColor(): boolean;

Gibt zurück

boolean

getMatchPositiveFillColor()

Gibt an, ob der negative Datenbalken dieselbe Füllfarbe wie der positive Datenbalken aufweist.

getMatchPositiveFillColor(): boolean;

Gibt zurück

boolean

setBorderColor(borderColor)

HTML-Farbcode, der die Farbe der Rahmenlinie in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt. Der Wert ist "" (eine leere Zeichenfolge), wenn kein Rahmen vorhanden oder festgelegt ist.

setBorderColor(borderColor: string): void;

Parameter

borderColor

string

Gibt zurück

void

setFillColor(fillColor)

HTML-Farbcode, der die Füllfarbe in form #RRGGBB (z. B. "FFA500") oder als benannte HTML-Farbe (z. B. "orange") darstellt.

setFillColor(fillColor: string): void;

Parameter

fillColor

string

Gibt zurück

void

setMatchPositiveBorderColor(matchPositiveBorderColor)

Gibt an, ob der negative Datenbalken die gleiche Rahmenfarbe wie der positive Datenbalken aufweist.

setMatchPositiveBorderColor(matchPositiveBorderColor: boolean): void;

Parameter

matchPositiveBorderColor

boolean

Gibt zurück

void

setMatchPositiveFillColor(matchPositiveFillColor)

Gibt an, ob der negative Datenbalken dieselbe Füllfarbe wie der positive Datenbalken aufweist.

setMatchPositiveFillColor(matchPositiveFillColor: boolean): void;

Parameter

matchPositiveFillColor

boolean

Gibt zurück

void