Новые возможности 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)	Вычисляет все ячейки на листе.

См. также

Обратная связь

Была ли эта страница полезна?

Last updated on 2025-12-17