Événements liés à la grille JS
Dernière modification : jeudi 2 septembre 2010
S’applique à : SharePoint Foundation 2010
Vous pouvez écrire du code qui s’exécute sur le client lorsqu’un événement particulier se produit sur le Contrôle Grille JS. Le rendu côté client de ce code est plus immédiat du point de vue de l’utilisateur, car aucun aller-retour avec le serveur n’est nécessaire.
Le Contrôle Grille JS offre les événements côté client suivants.
Événements liés à la grille JS
Événement |
Description |
|---|---|
OnBeforeGridDispose |
Se produit avant que la grille ne soit supprimée. Se produit une seule fois pendant la durée de vie du contrôle. |
OnCellEditBegin |
Se produit lorsque l’utilisateur a commencé à effectuer des opérations de modification (appui sur une touche, double-clic) dans un widget ou un contrôle d’édition, par exemple, lorsqu’il commence à taper dans une zone d’édition. |
OnCellEditCompleted |
Se produit après que l’utilisateur a terminé de modifier une cellule avec un widget ou un contrôle d’édition. Se produit également lors de l’actualisation d’une page (événement onLoad). |
OnCellErrorStateChanged |
Se produit lorsque l’état d’erreur de la cellule est ajouté ou supprimé. |
OnCellFocusChanged |
Se produit lorsque le focus change de cellule. |
OnDoubleClick |
Se produit lorsque l’utilisateur double-clique sur une cellule. |
OnEntryRecordAdded |
Se produit lorsqu’un nouvel enregistrement d’entrée apparaît sur le Contrôle Grille JS. |
OnEntryRecordCommitted |
Se produit lorsque l’entrée de l’enregistrement est validée, c’est-à-dire, lorsqu’un enregistrement d’entrée est correctement ajouté au cache de la table du Contrôle Grille JS. |
OnEntryRecordPropertyChanged |
Se produit lorsqu’une propriété d’un enregistrement d’entrée est modifiée. Cela inclut toutes les modifications utilisateur et par programme. |
OnGridErrorStateChanged |
Se produit lorsque la grille passe d’un état où elle comporte une ou plusieurs erreurs à celui où elle est dépourvue d’erreurs, ou inversement. |
OnInitialChangesForChangeKeyComplete(changeKey) |
Se produit la première fois que toutes les modifications liées à une clé de changement donnée ont été validées, c’est-à-dire lorsqu’aucun appel asynchrone n’est en attente. |
OnPropertyChanged |
Se produit lorsqu’une propriété d’un enregistrement est modifiée. Cela inclut toutes les modifications utilisateur et par programme. |
OnRecordChecked |
Se produit lorsqu’un ou plusieurs enregistrements sont activés ou désactivés à l’aide de la case à cocher de l’indicateur d’enregistrement. |
OnRecordDeleted |
Se produit lorsqu’un enregistrement est supprimé. |
OnRecordInserted |
Se produit lorsqu’un enregistrement est inséré. |
OnRightClick |
Se produit lorsque l’utilisateur clique avec le bouton droit sur la cellule. |
OnRowErrorStateChanged |
Se produit lorsque l’état d’erreur d’une ligne change. |
OnRowFocusChanged |
Se produit lorsque le focus change de ligne. |
OnSingleCellClick |
Se produit lorsque l’utilisateur clique une fois sur une cellule. |
OnSingleCellKeyDown |
Se produit lorsqu’une touche unique est appuyée. |
OnVacateChange |
Se produit lorsque la grille n’effectue plus le suivi d’une modification spécifiée. Par exemple, si l’utilisateur apporte une modification, l’annule, puis effectue une nouvelle modification, la première modification est ignorée. |
Attachement aux événements
Cet exemple montre comment attacher du code personnalisé à l’événement 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>