Excel.DataBarConditionalFormat interface

Представляет тип условных гистограмм Excel.

Свойства

axisColor

HTML-код цвета, представляющий цвет линии оси, из формы # RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "Апельсин"). "" (пустая строка), если ось отсутствует или не задана.

axisFormat

Представление определения оси для панели данных Excel.

barDirection

Указывает направление, на котором должен основываться рисунок на панели данных.

lowerBoundRule

Правило для нижней границы гистограммы (и как ее вычислить). ConditionalDataBarRuleОбъект должен быть задан как объект JSON (используйте x.lowerBoundRule = {...} вместоx.lowerBoundRule.formula = ...).

negativeFormat

Отображение всех значений слева от оси в панели данных Excel.

positiveFormat

Представление всех значений справа от оси в панели данных Excel.

showDataBarOnly

Значение true скрывает значения ячеек, где применяется гистограмма.

upperBoundRule

Правило для верхней границы гистограммы (и как ее вычислить). ConditionalDataBarRuleОбъект должен быть задан как объект JSON (используйте x.upperBoundRule = {...} вместоx.upperBoundRule.formula = ...).

Методы

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

Сведения о свойстве

axisColor

HTML-код цвета, представляющий цвет линии оси, из формы # RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "Апельсин"). "" (пустая строка), если ось отсутствует или не задана.

axisColor: string;

Значение свойства

string

axisFormat

Представление определения оси для панели данных Excel.

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

Значение свойства

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

barDirection

Указывает направление, на котором должен основываться рисунок на панели данных.

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

Значение свойства

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

Примеры

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

Правило для нижней границы гистограммы (и как ее вычислить). ConditionalDataBarRuleОбъект должен быть задан как объект JSON (используйте x.lowerBoundRule = {...} вместоx.lowerBoundRule.formula = ...).

lowerBoundRule: ConditionalDataBarRule;

Значение свойства

negativeFormat

Отображение всех значений слева от оси в панели данных Excel.

readonly negativeFormat: ConditionalDataBarNegativeFormat;

Значение свойства

positiveFormat

Представление всех значений справа от оси в панели данных Excel.

readonly positiveFormat: ConditionalDataBarPositiveFormat;

Значение свойства

showDataBarOnly

Значение true скрывает значения ячеек, где применяется гистограмма.

showDataBarOnly: boolean;

Значение свойства

boolean

upperBoundRule

Правило для верхней границы гистограммы (и как ее вычислить). ConditionalDataBarRuleОбъект должен быть задан как объект JSON (используйте x.upperBoundRule = {...} вместоx.upperBoundRule.formula = ...).

upperBoundRule: ConditionalDataBarRule;

Значение свойства

Сведения о методе

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

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

Параметры

propertyNames
string | string[]

Строка, разделенная запятыми, или массив строк, указывающий свойства для загрузки.

Возвращаемое значение

void