Compartilhar via

ExcelScript.ConditionalDataBarPositiveFormat interface

Pacote:
ExcelScript

Representa um formato condicional para o lado positivo da barra de dados.

Comentários

Exemplos

/**
 * 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étodos

getBorderColor()

Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). O valor é "" (uma cadeia vazia) se não existir um limite ou estiver definido.
getFillColor()

Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
getGradientFill()

Especifica se a barra de dados tem uma gradação.
setBorderColor(borderColor)

Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). O valor é "" (uma cadeia vazia) se não existir um limite ou estiver definido.
setFillColor(fillColor)

Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
setGradientFill(gradientFill)

Especifica se a barra de dados tem uma gradação.

Detalhes do método

getBorderColor()

Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). O valor é "" (uma cadeia vazia) se não existir um limite ou estiver definido.

getBorderColor(): string;

Retornos

string

getFillColor()

Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").

getFillColor(): string;

Retornos

string

getGradientFill()

Especifica se a barra de dados tem uma gradação.

getGradientFill(): boolean;

Retornos

boolean

setBorderColor(borderColor)

Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). O valor é "" (uma cadeia vazia) se não existir um limite ou estiver definido.

setBorderColor(borderColor: string): void;

Parâmetros

borderColor

string

Retornos

void

setFillColor(fillColor)

Código de cores HTML que representa a cor de preenchimento, no formulário #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").

setFillColor(fillColor: string): void;

Parâmetros

fillColor

string

Retornos

void

setGradientFill(gradientFill)

Especifica se a barra de dados tem uma gradação.

setGradientFill(gradientFill: boolean): void;

Parâmetros

gradientFill

boolean

Retornos

void