RecordRange (对象)

说明

RecordRange对象代表记录Record,如果RecordRange在Sheet上返回，则此RecordRange指向的是Sheet上的数据，如果RecordRange在View上返回，则此RecordRange指向的是视图上的数据。我们为RecordRange提供了多种读取数据的方法。

字段选择器可以使用以下几种来选取记录

1、通过数值指定索引的记录

RecordRange(1)

2、通过指定记录ID来指定记录

RecordRange("a")

3、通过符号:可以指定索引范围的记录

RecordRange("1:100")

4、通过数组可以指定不连续的记录

RecordRange(["1","5","10:20"])

5、通过参数2为字符串指定字段ID可以限定显示的字段

RecordRange(1, "a")

6、通过参数2为数组可以指定多个字段ID可以限定显示的字段

RecordRange(1, ["a","b","A"])

7、通过参数2如果以@字符作为首字符表示字段名称

RecordRange(1, ["@名称", "@数量"])

8、通过 Condition() 方法来筛选符合条件的记录

方法

• Item
• Add
• Condition
• Delete
• Select
• SetValues

属性

• Id
• Index
• FieldId
• Count
• Text
• Value
• Font
• Interior

事件

• OnUpdate
• OnDeleteRecord

浏览器环境示例

async function example() {
 await instance.ready();
 const app = instance.Application;
 const values = await app.ActiveView.RecordRange(1, ["@名称", "@日期", "@数量"]).Value
 console.log(values) // 输出 (3) ['aaaa', 45470, 1]
}

脚本编辑器 示例

function main() {
 const values = Application.ActiveView.RecordRange(1, ["@名称", "@日期", "@数量"]).Value
 console.log(values) // 输出 (3) ['aaaa', 45470, 1]
}
main()