18.表单事件.md

表单事件

Excel.View.Sheets 在表单上提供了丰富的事件。你可以通过这些事件处理自己应用程序的业务逻辑

你可以通过调用 bind 和 unbind 方法来监听表单的某一个事件或取消监听表单的某一个事件。你可以调用 unbindAll 方法来取消监听表单所有的事件。表单提供了与 jquery 的事件监听和取消监听相类似的机制。例如:

var excel = $('#ss').data('workbook');
var sheet = excel.getActiveSheet();
var selectionChanged = Excel.View.Sheets.Events.SelectionChanged;
sheet.bind(selectionChanged, function(e,args) { // sheet event
   // do some thing...
});
// remove the binding of an event on the sheet.
sheet.unbind(selectionChanged); 
// removes the binding of all events on the sheet.
sheet.unbindAll(); 

如果你执行多个任务导致事件触发了很多次,而你并不想表单在每次任务执行时都触发相应的事件, 你可以调用 suspendEvent 方法来挂起事件触发机制。当所有任务执行完毕之后, 你可以调用 resumeEvent 方法来重新唤醒事件触发机制, 示例代码如下:

var excel = $('#ss').data('workbook');
var sheet = excel.getActiveSheet();
sheet.suspendEvent();
//do some operation...
sheet.resumeEvent();