跳到主要内容

AddAboveAverage

向集合添加新的高于平均值条件格式规则。

语法

expression.AddAboveAverage();

expression - 表示 ApiFormatConditions 类的变量。

参数

此方法没有任何参数。

返回值

ApiAboveAverage | null

示例

高亮显示电子表格中值超过范围平均值的单元格。

// How do I automatically mark cells that are above the group average in a spreadsheet?

// Draw attention to standout high values by coloring them relative to the mean in a spreadsheet.

let worksheet = Api.GetActiveSheet();

worksheet.GetRange("A1").SetValue("Test Scores");
worksheet.GetRange("A2").SetValue(85);
worksheet.GetRange("A3").SetValue(92);
worksheet.GetRange("A4").SetValue(78);
worksheet.GetRange("A5").SetValue(88);
worksheet.GetRange("A6").SetValue(95);
worksheet.GetRange("A7").SetValue(72);
worksheet.GetRange("A8").SetValue(90);

let dataRange = worksheet.GetRange("A2:A8");

let formatConditions = dataRange.GetFormatConditions();

let aboveAverageCondition = formatConditions.AddAboveAverage();
if (aboveAverageCondition) {
aboveAverageCondition.SetFillColor(Api.CreateColorFromRGB(144, 238, 144));
}