JS Grid-Ereignisse
Letzte Änderung: Donnerstag, 2. September 2010
Gilt für: SharePoint Foundation 2010
Sie können Code schreiben, der auf dem Client ausgeführt wird, wenn ein bestimmtes Ereignis im JS Grid-Steuerelement auftritt. Das clientseitige Rendering dieses Codes stellt unmittelbareres Feedback für den Benutzer bereit, da kein Roundtrip zum Server erforderlich ist.
Das JS Grid-Steuerelement bietet die folgenden clientseitigen Ereignisse.
JS Grid-Ereignisse
Ereignis |
Beschreibung |
|---|---|
OnBeforeGridDispose |
Tritt auf, bevor das Raster verworfen wird. Tritt nur einmal im Lebenszyklus des Steuerelements auf. |
OnCellEditBegin |
Tritt auf, wenn der Benutzer mit der Bearbeitung (durch Tastendruck, Doppelklick) in einem Bearbeitungssteuerelement oder Widget begonnen hat, wenn der Benutzer z. B. mit dem Eingeben in ein Bearbeitungsfeld beginnt. |
OnCellEditCompleted |
Tritt auf, nachdem der Benutzer die Bearbeitung einer Zelle mit einem Bearbeitungssteuerelement oder Widget beendet hat. Tritt auch bei einer Seitenaktualisierung (einem onLoad-Ereignis) auf. |
OnCellErrorStateChanged |
Tritt auf, wenn der Zellenfehlerstatus hinzugefügt oder entfernt wird. |
OnCellFocusChanged |
Tritt nach der Änderung des Zellfokus auf. |
OnDoubleClick |
Tritt auf, wenn der Benutzer auf eine Zelle doppelklickt. |
OnEntryRecordAdded |
Tritt auf, wenn ein neuer Eintragsdatensatz im JS Grid-Steuerelement angezeigt wird. |
OnEntryRecordCommitted |
Tritt auf, wenn ein Commit für den Datensatzeintrag ausgeführt wurde, d. h., wenn ein Eintragsdatensatz dem JS Grid-Steuerelement-Tabellencache erfolgreich hinzugefügt wurde. |
OnEntryRecordPropertyChanged |
Tritt auf, wenn eine Eigenschaft eines Eintragsdatensatzes geändert wird. Eingeschlossen sind alle benutzer- und programmseitigen Bearbeitungen. |
OnGridErrorStateChanged |
Tritt auf, wenn sich das Raster aus dem Status mit mindestens einem Fehler in den Status mit keinem Fehler ändert oder umgekehrt. |
OnInitialChangesForChangeKeyComplete(changeKey) |
Tritt auf, wenn zum ersten Mal alle mit einem bestimmten Änderungsschlüssel verbundenen Änderungen überprüft worden sind, d. h., wenn keine asynchronen Aufrufe ausstehen. |
OnPropertyChanged |
Tritt auf, wenn eine Eigenschaft eines Datensatzes geändert wird. Eingeschlossen sind alle benutzer- und programmseitigen Bearbeitungen. |
OnRecordChecked |
Tritt auf, wenn mindestens ein Datensatz eingecheckt oder ausgecheckt wird, indem das Kontrollkästchen für den Datensatzindikator verwendet wird. |
OnRecordDeleted |
Tritt ein, wenn ein Datensatz gelöscht wird. |
OnRecordInserted |
Tritt ein, wenn ein Datensatz eingefügt wird. |
OnRightClick |
Tritt auf, wenn der Benutzer mit der rechten Maustaste auf eine Zelle klickt. |
OnRowErrorStateChanged |
Tritt auf, wenn der Fehlerstatus einer Zeile geändert wird. |
OnRowFocusChanged |
Tritt bei Änderung des Zeilenfokus auf. |
OnSingleCellClick |
Tritt auf, wenn der Benutzer auf eine Zelle klickt. |
OnSingleCellKeyDown |
Tritt auf, wenn eine Taste gedrückt wird. |
OnVacateChange |
Tritt auf, wenn das Raster eine angegebene Änderung nicht mehr nachverfolgt. Wenn der Benutzer beispielsweise eine Änderung vornimmt, eine Änderung rückgängig macht und dann eine andere Änderung vornimmt, wird die erste Änderung frei gegeben. |
Anfügen an Ereignisse
In diesem Beispiel wird das Anfügen von benutzerdefiniertem Code an das OnCellEditComplete-Ereignis gezeigt.
<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>