跳到主要内容

GetItem

按索引返回格式条件。

语法

expression.GetItem(index);

expression - 表示 ApiFormatConditions 类的变量。

参数

名称必需/可选数据类型默认值描述
index必需number格式条件的索引(从 1 开始)。

返回值

ApiFormatCondition | null

示例

此示例按索引获取特定的条件格式规则。

// How to get individual conditional formatting rules from a collection.

// Get specific conditional formatting rule by index.

let worksheet = Api.GetActiveSheet();

worksheet.GetRange("A1").SetValue("Sample Data");
worksheet.GetRange("A2").SetValue(10);
worksheet.GetRange("A3").SetValue(45);
worksheet.GetRange("A4").SetValue(75);
worksheet.GetRange("A5").SetValue(25);
worksheet.GetRange("A6").SetValue(90);

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

let formatConditions = dataRange.GetFormatConditions();

formatConditions.AddDatabar();

let firstRule = formatConditions.GetItem(1);

worksheet.GetRange("B1").SetValue("Rule found: " + (firstRule !== null));