Новые возможности API JavaScript для Excel 1.6

  • Статья

Условное форматирование

Вводит условное форматирование диапазона. Разрешает следующие типы условного форматирования.

  • Цветовая шкала
  • Гистограмма
  • Набор значков
  • Настраиваемый

Дополнительно:

  • Возврат диапазона, к которому применено условное форматирование.
  • Удаление условного форматирования.
  • Предоставляет приоритет и stopifTrue возможности.
  • Получение полной коллекции условного форматирования для определенного диапазона.
  • Полное удаление условного форматирование в указанном диапазоне.

Список API

В следующей таблице перечислены API в наборе обязательных api JavaScript для Excel 1.6. Справочную документацию по API для всех API, поддерживаемых набором обязательных API JavaScript для Excel 1.6 или более ранней версии, см. в статье Api Excel в наборе требований 1.6 или более ранней версии.

Класс Поля Описание
Application suspendApiCalculationUntilNextSync() Приостанавливает вычисление до вызова следующего context.sync() .
CellValueConditionalFormat format Возвращает объект форматирования, инкапсулирующий шрифт, заливку, границы и другие свойства условных форматов.
Правило Указывает объект правила в этом условном формате.
ColorScaleConditionalFormat criteria Критерии цветовой шкалы.
threeColorScale Если trueзадано значение , цветовая шкала будет иметь три точки (минимальная, средняя, максимальная), в противном случае она будет иметь два (минимум, максимум).
ConditionalCellValueRule formula1 Формула, если требуется, по которой вычисляет правило условного формата.
формула 2 Формула, если требуется, по которой вычисляет правило условного формата.
operator Оператор условного формата значения ячейки.
ConditionalColorScaleCriteria maximum Максимальная точка критерия цветовой шкалы.
Середина Средняя точка критерия цветовой шкалы, если цветовая шкала является 3-цветовой шкалой.
minimum Минимальная точка критерия цветовой шкалы.
ConditionalColorScaleCriterion color Представление цветового кода HTML цвета цветовой шкалы (например, #FF0000 представляет красный цвет).
formula Число, формула или null (если type имеет значение lowestValue).
type На чем должна основываться условная формула критерия.
ConditionalDataBarNegativeFormat Bordercolor Код цвета HTML, представляющий цвет линии границы в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
Fillcolor Код цвета HTML, представляющий цвет заливки, в форме #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
matchPositiveBorderColor Указывает, имеет ли отрицательная панель данных тот же цвет границы, что и у положительной панели данных.
matchPositiveFillColor Указывает, имеет ли отрицательная панель данных тот же цвет заливки, что и положительная панель данных.
ConditionalDataBarPositiveFormat Bordercolor Код цвета HTML, представляющий цвет линии границы в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
Fillcolor Код цвета HTML, представляющий цвет заливки, в форме #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
gradientFill Указывает, имеет ли панель данных градиент.
ConditionalDataBarRule formula Формула, если требуется, по которой вычисляет правило линейчатой строки данных.
type Тип правила для панели данных.
ConditionalFormat cellValue Возвращает свойства условного формата значения ячейки, если текущий условный формат является типом CellValue .
cellValueOrNullObject Возвращает свойства условного формата значения ячейки, если текущий условный формат является типом CellValue .
colorScale Возвращает свойства условного формата цветовой шкалы, если текущий условный формат является типом ColorScale .
colorScaleOrNullObject Возвращает свойства условного формата цветовой шкалы, если текущий условный формат является типом ColorScale .
Пользовательские Возвращает свойства пользовательского условного формата, если текущий условный формат является пользовательским типом.
customOrNullObject Возвращает свойства пользовательского условного формата, если текущий условный формат является пользовательским типом.
Databar Возвращает свойства панели данных, если текущий условный формат является панелью данных.
dataBarOrNullObject Возвращает свойства панели данных, если текущий условный формат является панелью данных.
delete() Удаляет это условное форматирование.
getRange() Возврат диапазона, к которому применено условное форматирование.
getRangeOrNullObject() Возвращает диапазон, к которому применяется кондитональный формат.
Iconset Возвращает свойства условного формата набора значков, если текущий условный формат является типом IconSet .
iconSetOrNullObject Возвращает свойства условного формата набора значков, если текущий условный формат является типом IconSet .
id Приоритет условного формата в текущем ConditionalFormatCollection.
Предустановленных Возвращает предустановленный условный формат условия.
presetOrNullObject Возвращает предустановленный условный формат условия.
Приоритет Приоритет (или индекс) в коллекции условного формата, в которую в настоящее время существует этот условный формат.
stopIfTrue Если выполняются условия этого условного форматирования, форматы с более низким приоритетом не будут применяться в этой ячейке.
textComparison Возвращает определенные свойства условного формата текста, если текущий условный формат является текстовым типом.
textComparisonOrNullObject Возвращает определенные свойства условного формата текста, если текущий условный формат является текстовым типом.
topBottom Возвращает свойства верхнего или нижнего условного формата, если текущий условный формат является типом TopBottom .
topBottomOrNullObject Возвращает свойства верхнего или нижнего условного формата, если текущий условный формат является типом TopBottom .
type Тип условного формата.
ConditionalFormatCollection add(type: Excel.ConditionalFormatType) Добавляет новый условный формат в коллекцию с первым или верхним приоритетом.
clearAll() Полное удаление условного форматирование в указанном диапазоне.
getCount() Возвращает количество условных форматов в книге.
getItem(id: string) Возвращает условное форматирование для указанного идентификатора.
getItemAt(index: number) Возвращает условное форматирование по индексу.
items Получает загруженные дочерние элементы в этой коллекции.
ConditionalFormatRule formula Формула, если требуется, по которой вычисляет правило условного формата.
formulaLocal Формула, если это необходимо, для оценки правила условного формата на языке пользователя.
formulaR1C1 Формула, если это необходимо, для оценки правила условного формата в нотации в стиле R1C1.
ConditionalIconCriterion customIcon Пользовательский значок для текущего критерия, если он отличается от установленного по умолчанию значка, в противном случае null будет возвращен.
formula Число или формула в зависимости от типа.
operator greaterThan или greaterThanOrEqual для каждого из типов правил условного формата значка.
type На чем должна основываться условная формула значка.
ConditionalPresetCriteriaRule Критерий Условие условного формата.
ConditionalRangeBorder color Код цвета HTML, представляющий цвет линии границы в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
sideIndex Постоянное значение, указывающее определенную сторону границы.
style Одна из констант стиля линии, определяющая стиль линии границы.
ConditionalRangeBorderCollection bottom Возвращает нижнюю границу.
count Количество объектов границы в коллекции.
getItem(index: Excel.ConditionalRangeBorderIndex) Возвращает объект границы по его имени.
getItemAt(index: number) Возвращает объект границы по его индексу.
items Получает загруженные дочерние элементы в этой коллекции.
left Возвращает левую границу.
right Возвращает правильную границу.
top Возвращает верхнюю границу.
ConditionalRangeFill clear() Удаляет заливку.
color Код цвета HTML, представляющий цвет заливки, в форме #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
ConditionalRangeFont bold Указывает, является ли шрифт полужирным.
clear() Удаляет форматирование шрифтов.
color Представление цветового кода HTML для цвета текста (например, #FF0000 представляет красный цвет).
italic Указывает, является ли шрифт курсивом.
strikethrough Указывает состояние зачеркиния шрифта.
underline Тип подчеркивания, примененного к шрифту.
ConditionalRangeFormat borders Коллекция объектов границы, которые применяются к общему диапазону условного формата.
fill Возвращает объект заполнения, определенный в общем диапазоне условного формата.
font Возвращает объект шрифта, определенный в общем диапазоне условного формата.
numberFormat Представляет код числового формата Excel для заданного диапазона.
ConditionalTextComparisonRule operator Оператор условного формата текста.
text Текстовое значение условного формата.
ConditionalTopBottomRule rank От 1 до 1000 для числовых рейтингов или от 1 до 100 для процентных рейтингов.
type Форматируйте значения на основе верхнего или нижнего ранга.
CustomConditionalFormat format Возвращает объект форматирования, инкапсулирующий шрифт, заливку, границы и другие свойства условных форматов.
Правило Указывает объект в Rule этом условном формате.
DataBarConditionalFormat axisColor Код цвета HTML, представляющий цвет линии оси в виде #RRGGBB (например, "FFA500") или в виде именованного цвета HTML (например, "оранжевый").
axisFormat Представление определения оси для панели данных Excel.
barDirection Указывает направление, на котором должен основываться рисунок панели данных.
lowerBoundRule Правило для того, что составляет нижнюю границу (и как ее вычислить, если применимо) для панели данных.
negativeFormat Представление всех значений слева от оси на панели данных Excel.
positiveFormat Представление всех значений справа от оси на панели данных Excel.
showDataBarOnly Если trueзначение , то скрывает значения из ячеек, в которых применяется панель данных.
upperBoundRule Правило для верхней границы гистограммы (и как ее вычислить).
IconSetConditionalFormat criteria Массив критериев и наборов значков для правил и потенциальных настраиваемых значков для условных значков.
reverseIconOrder Если trueзначение , отменяет порядок значков для набора значков.
showIconOnly Если trueзначение , скрывает значения и отображает только значки.
style Если задано значение , отображает параметр набора значков для условного формата.
PresetCriteriaConditionalFormat format Возвращает объект форматирования, инкапсулирующий шрифт, заливку, границы и другие свойства условных форматов.
Правило Правило условного форматирования.
Range calculate() Вычисляет диапазон ячеек на листе.
conditionalFormats Коллекция, ConditionalFormats пересекающая диапазон.
TextConditionalFormat format Возвращает объект формата, инкапсулирующий шрифт, заливку, границы и другие свойства условного формата.
Правило Правило условного форматирования.
TopBottomConditionalFormat format Возвращает объект формата, инкапсулирующий шрифт, заливку, границы и другие свойства условного формата.
Правило Критерии условного формата верхнего и нижнего.
Worksheet calculate(markAllDirty: boolean) Вычисляет все ячейки на листе.

См. также