监听修改记录的事件

RecordRange.OnUpdate(方法)

说明

为 RecordRange 添加 Update 事件,当更新 RecordRange 时触发。注意在脚本编辑器中使用时，脚本运行结束就会退出运行，这时可能回调无法被正常触发

语法

表达式: OnUpdate(Callback)

表达式: RecordRange

参数

参数名	是否必需	类型	描述
Callback	是	func	指定事件发生时的回调方法 ; const eventContext = await RecordRange.OnUpdate(()=>{ ... })

返回值

EventContext

事件返回数据

[RecordRange]

浏览器环境示例

async function example() {
    await instance.ready();
    const app = instance.Application;
    let eventContext;
    eventContext = await app
        .Sheets(1)
        .Views(1)
        .RecordRange(1)
        .OnUpdate(data => {
            console.log(data);
            // 取消事件监听
            eventContext.Destroy();
        });
    app.Sheets(1).Views(1).RecordRange(1).Value = ['名称111', 4, '选项1'];
}

脚本编辑器 示例

function main() {
    let eventContext;
    eventContext = Application.Sheets(1)
        .Views(1)
        .RecordRange(1)
        .OnUpdate(data => {
            console.log(data);
            // 取消事件监听
            eventContext.Destroy();
        });
    Application.Sheets(1).Views(1).RecordRange(1).Value = ['名称111', 4, '选项1'];
}
main();