detachEvent

取消订阅指定事件。

语法

expression.detachEvent(eventName);

expression - 表示 Api 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
eventName	必需	string		事件名称。

返回值

此方法不返回任何数据。

示例

在不再需要时停止监听电子表格中的单元格更改通知。

// How do I unregister a previously attached change listener in a spreadsheet?

// Prevent a handler from firing on future edits by removing it from the event queue in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let range = worksheet.GetRange("A1");
range.SetValue("1");
Api.attachEvent("onWorksheetChange", function(range){
    console.log("onWorksheetChange");
    console.log(range.GetAddress());
});
Api.detachEvent("onWorksheetChange");