События JS Grid
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
Можно написать код, который исполняется на клиенте при возникновении определенного события в управления JS Grid. Отображение этого кода на клиенте обеспечивает пользователю более быструю обратную связь, поскольку в этом случае не требуется обращение к серверу.
управления JS Grid предлагает следующие клиентские события.
События JS Grid
Событие |
Описание |
|---|---|
OnBeforeGridDispose |
Возникает перед удалением сетки. Возникает один раз в течение всего времени существования элемента управления. |
OnCellEditBegin |
Возникает, когда пользователь начинает ввод (нажатие клавиши, двойной щелчок мыши) в элементе управления для редактирования или в мини-приложении, например при начале ввода текста в поле для редактирования. |
OnCellEditCompleted |
Возникает после окончания редактирования ячейки с помощью элемента управления для редактирования или мини-приложения. Возникает также при обновлении страницы (событие onLoad). |
OnCellErrorStateChanged |
Возникает, когда добавляется или удаляется состояние ошибки ячейки. |
OnCellFocusChanged |
Возникает после изменения фокуса ячейки. |
OnDoubleClick |
Возникает при двойном щелчке ячейки. |
OnEntryRecordAdded |
Возникает, когда в управления JS Grid появляется новая запись. |
OnEntryRecordCommitted |
Возникает при фиксации записи, то есть когда запись успешно добавляется в кэш таблицы управления JS Grid. |
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>