JS 网格事件
上次修改时间： 2015年3月9日
适用范围： SharePoint Foundation 2010
您可以编写 JS 网格控件上发生特定事件时在客户端上执行的代码。因为不需要往返于服务器，所以此代码的客户端呈现为用户提供更快速的反馈。
JS 网格控件提供以下客户端事件。
JS 网格事件
事件 |
说明 |
|---|---|
OnBeforeGridDispose |
在网格被释放前发生。在控件的生命周期中仅发生一次。 |
OnCellEditBegin |
用户已开始在编辑控件或小组件中进行编辑（按键、双击）时发生；例如，当用户开始在编辑框中键入内容时。 |
OnCellEditCompleted |
用户已使用编辑控件或小组件完成单元格编辑时发生。在刷新页面（onLoad 事件）时也会发生。 |
OnCellErrorStateChanged |
添加或删除错误状态时发生。 |
OnCellFocusChanged |
单元格焦点更改时发生。 |
OnDoubleClick |
用户双击单元格时发生。 |
OnEntryRecordAdded |
新的项记录显示在 JS 网格控件上时发生。 |
OnEntryRecordCommitted |
记录项已提交时发生；即，项记录成功添加到 JS 网格控件表格缓存中时。 |
OnEntryRecordPropertyChanged |
项记录的属性更改时发生。这包括所有用户和编程式编辑。 |
OnGridErrorStateChanged |
网格从有一个或多个错误的状态改变为没有错误的状态（或相反）时发生。 |
OnInitialChangesForChangeKeyComplete(changeKey) |
与给定更改密钥关联的所有更改首次通过验证时发生。即，没有挂起的异步调用。 |
OnPropertyChanged |
记录的属性更改时发生。包括所有用户和编程式编辑。 |
OnRecordChecked |
使用记录指示器复选框选中或取消选中一项或多项记录时发生。 |
OnRecordDeleted |
删除记录时发生。 |
OnRecordInserted |
插入记录时发生。 |
OnRightClick |
用户右键单击单元格时发生。 |
OnRowErrorStateChanged |
行的错误状态更改时发生。 |
OnRowFocusChanged |
行焦点更改时发生。 |
OnSingleCellClick |
用户单击单元格时发生。 |
OnSingleCellKeyDown |
按下单个按键时发生。 |
OnVacateChange |
网格不再跟踪特定的更改时发生。例如，如果用户进行更改、取消此更改，然后进行不同的更改，则第一次的更改将被撤消。 |
附加到事件
此示例展示了如何将自定义代码附加到 OnCellEditComplete 事件。
<script type="text/javascript">
Type.registerNamespace("GridManager");
GridManager = function () {
this.Init = function (jsGridControl, initialData, props) {
control = jsGridControl;
var dataSource = new SP.JsGrid.StaticDataSource(initialData);
var jsGridParams = dataSource.InitJsGridParams();
// This event is triggered after the standard grid error checking.
jsGridControl.AttachEvent(SP.JsGrid.EventType.OnCellEditCompleted, GotHere);
jsGridControl.Init(jsGridParams);
}
};
function GotHere(obj) {
alert('Got Here, ' + obj.fieldKey);
}
</script>