Excel.DataBarConditionalFormat interface

Representa um tipo de barra de dados condicional do Excel.

Propriedades

axisColor

Código de cor HTML que representa a cor da linha do eixo, da forma # RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). "" (cadeia de caracteres vazia) se nenhum eixo estiver presente ou definido.

axisFormat

Representação de como o eixo é determinado para uma barra de dados do Excel.

barDirection

Especifica a direção na qual o gráfico da barra de dados deve se basear.

lowerBoundRule

A regra para o que constitui o limite inferior (e como calculá-lo, se aplicável) para uma barra de dados. O ConditionalDataBarRule objeto deve ser definido como um objeto JSON (use x.lowerBoundRule = {...} em vez dex.lowerBoundRule.formula = ...).

negativeFormat

Representação de todos os valores à esquerda do eixo em uma barra de dados do Excel.

positiveFormat

Representação de todos os valores à direita do eixo em uma barra de dados do Excel.

showDataBarOnly

Caso verdadeiro, oculta os valores das células às quais a barra de dados é aplicada.

upperBoundRule

A regra para o que constitui o limite superior (e como calculá-lo, se aplicável) para uma barra de dados. O ConditionalDataBarRule objeto deve ser definido como um objeto JSON (use x.upperBoundRule = {...} em vez dex.upperBoundRule.formula = ...).

Métodos

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

Detalhes da propriedade

axisColor

Código de cor HTML que representa a cor da linha do eixo, da forma # RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja"). "" (cadeia de caracteres vazia) se nenhum eixo estiver presente ou definido.

axisColor: string;

Valor da propriedade

string

axisFormat

Representação de como o eixo é determinado para uma barra de dados do Excel.

axisFormat:
            | ConditionalDataBarAxisFormat
            | "Automatic"
            | "None"
            | "CellMidPoint";

Valor da propriedade

| ConditionalDataBarAxisFormat | "Automatic" | "None" | "CellMidPoint"

barDirection

Especifica a direção na qual o gráfico da barra de dados deve se basear.

barDirection:
            | ConditionalDataBarDirection
            | "Context"
            | "LeftToRight"
            | "RightToLeft";

Valor da propriedade

| ConditionalDataBarDirection | "Context" | "LeftToRight" | "RightToLeft"

Exemplos

async function main(context: Excel.RequestContext) {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B8:E13");
    let conditionalFormat = range.conditionalFormats
        .add(Excel.ConditionalFormatType.dataBar);
    conditionalFormat.dataBar.barDirection = Excel.ConditionalDataBarDirection.leftToRight;

    await context.sync();
}

lowerBoundRule

A regra para o que constitui o limite inferior (e como calculá-lo, se aplicável) para uma barra de dados. O ConditionalDataBarRule objeto deve ser definido como um objeto JSON (use x.lowerBoundRule = {...} em vez dex.lowerBoundRule.formula = ...).

lowerBoundRule: ConditionalDataBarRule;

Valor da propriedade

negativeFormat

Representação de todos os valores à esquerda do eixo em uma barra de dados do Excel.

readonly negativeFormat: ConditionalDataBarNegativeFormat;

Valor da propriedade

positiveFormat

Representação de todos os valores à direita do eixo em uma barra de dados do Excel.

readonly positiveFormat: ConditionalDataBarPositiveFormat;

Valor da propriedade

showDataBarOnly

Caso verdadeiro, oculta os valores das células às quais a barra de dados é aplicada.

showDataBarOnly: boolean;

Valor da propriedade

boolean

upperBoundRule

A regra para o que constitui o limite superior (e como calculá-lo, se aplicável) para uma barra de dados. O ConditionalDataBarRule objeto deve ser definido como um objeto JSON (use x.upperBoundRule = {...} em vez dex.upperBoundRule.formula = ...).

upperBoundRule: ConditionalDataBarRule;

Valor da propriedade

Detalhes do método

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): void;

Parâmetros

propertyNames
string | string[]

Uma cadeia de caracteres delimitada por vírgula ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

void