Excel.ColorScaleConditionalFormat interface

Representa critérios de formatação condicional.

Propriedades

criteria

Os critérios da escala de cores. O ponto médio é opcional ao usar uma escala de cores de dois pontos.

threeColorScale

Se true, a escala de cores terá três pontos (mínimo, ponto médio, máximo), caso contrário, terá dois (mínimo, máximo).

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

criteria

Os critérios da escala de cores. O ponto médio é opcional ao usar uma escala de cores de dois pontos.

criteria: ConditionalColorScaleCriteria;

Valor da propriedade

Exemplos

async function main(context: Excel.RequestContext) {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B2:M5");
    let conditionalFormat = range.conditionalFormats
        .add(Excel.ConditionalFormatType.colorScale);
    let criteria = {
        minimum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.lowestValue, color: "blue" },
        midpoint: { formula: "50", type: Excel.ConditionalFormatColorCriterionType.percent, color: "yellow" },
        maximum: { formula: null, type: Excel.ConditionalFormatColorCriterionType.highestValue, color: "red" }
    };
    conditionalFormat.colorScale.criteria = criteria;

    await context.sync();
}

threeColorScale

Se true, a escala de cores terá três pontos (mínimo, ponto médio, máximo), caso contrário, terá dois (mínimo, máximo).

readonly threeColorScale: boolean;

Valor da propriedade

boolean

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