跳到主要内容

SetPercentileValues

指定图标集条件格式的阈值是否使用百分位数确定。

语法

expression.SetPercentileValues(percentileValues);

expression - 表示 ApiIconSetCondition 类的变量。

参数

名称必需/可选数据类型默认值描述
percentileValues必需boolean为 true 时将所有阈值设置为百分位数,否则为 false。

返回值

boolean

示例

此示例演示如何为图标集阈值启用百分位数值。

// How to configure icon set to use percentile values instead of actual values.

// Enable percentile values for icon set threshold calculation.

let worksheet = Api.GetActiveSheet();

worksheet.GetRange("A1").SetValue("Scores");
worksheet.GetRange("A2").SetValue(95);
worksheet.GetRange("A3").SetValue(80);
worksheet.GetRange("A4").SetValue(65);
worksheet.GetRange("A5").SetValue(50);
worksheet.GetRange("A6").SetValue(35);

let range = worksheet.GetRange("A2:A6");
let formatConditions = range.GetFormatConditions();
let iconCondition = formatConditions.AddIconSetCondition();

worksheet.GetRange("B1").SetValue("Before: Using number values");
iconCondition.SetPercentileValues(true);
worksheet.GetRange("B2").SetValue("After: Using percentile values");