Freigeben über

ExcelScript.ConditionalDataBarPositiveFormat interface

Paket:
ExcelScript

Stellt ein bedingtes Format für die positive 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.
getGradientFill()

Gibt an, ob der Datenbalken einen Farbverlauf 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.
setGradientFill(gradientFill)

Gibt an, ob der Datenbalken einen Farbverlauf 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

getGradientFill()

Gibt an, ob der Datenbalken einen Farbverlauf aufweist.

getGradientFill(): 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

setGradientFill(gradientFill)

Gibt an, ob der Datenbalken einen Farbverlauf aufweist.

setGradientFill(gradientFill: boolean): void;

Parameter

gradientFill

boolean

Gibt zurück

void