ExcelScript.ConditionalIconCriterion interface
Представляет условие значка, содержащее тип, значение, оператор и необязательный настраиваемый значок, если набор значков не используется.
Комментарии
Примеры
/**
* This script applies icon set conditional formatting to a range.
*/
function main(workbook: ExcelScript.Workbook) {
// Get the range "A1:A5" on the current worksheet.
const sheet = workbook.getActiveWorksheet();
const range = sheet.getRange("A1:A5");
// Create icon set conditional formatting on the range.
const conditionalFormatting = range.addConditionalFormat(ExcelScript.ConditionalFormatType.iconSet);
// Use the "3 Traffic Lights (Unrimmed)" set.
conditionalFormatting.getIconSet().setStyle(ExcelScript.IconSet.threeTrafficLights1);
// Set the criteria to use a different icon for the bottom, middle, and top thirds of the values in the range.
const criteria: ExcelScript.ConditionalIconCriterion[] = [
{
formula: '=0', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
type: ExcelScript.ConditionalFormatIconRuleType.percent
},
{
formula: '=33', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
type: ExcelScript.ConditionalFormatIconRuleType.percent
},
{
formula: '=67', operator: ExcelScript.ConditionalIconCriterionOperator.greaterThanOrEqual,
type: ExcelScript.ConditionalFormatIconRuleType.percent
}];
conditionalFormatting.getIconSet().setCriteria(criteria);
}
Свойства
custom |
Пользовательский значок для текущего критерия, если он отличается от установленного по умолчанию значка, в противном случае |
formula | Число или формула в зависимости от типа. |
operator |
|
type | На чем должна основываться условная формула значка. |
Сведения о свойстве
customIcon
Пользовательский значок для текущего критерия, если он отличается от установленного по умолчанию значка, в противном случае null
будет возвращен.
customIcon?: Icon;
Значение свойства
formula
Число или формула в зависимости от типа.
formula: string;
Значение свойства
string
operator
greaterThan
или greaterThanOrEqual
для каждого из типов правил условного формата значка.
operator: ConditionalIconCriterionOperator;
Значение свойства
type
На чем должна основываться условная формула значка.
type: ConditionalFormatIconRuleType;
Значение свойства
Office Scripts