Data.Win.ADODB.TCustomADODataSet.OnMoveComplete
Delphi
property OnMoveComplete: TRecordsetErrorEvent read FOnMoveComplete write FOnMoveComplete;
C++
__property TRecordsetErrorEvent OnMoveComplete = {read=FOnMoveComplete, write=FOnMoveComplete};
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| event | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
Description
Se produit quand le pointeur de ligne d'un ensemble d'enregistrements a été déplacé.
Ecrivez un gestionnaire d'événement OnMoveComplete pour effectuer des actions spécifiques quand le pointeur de ligne a été déplacé dans l'objet Recordset du composant ensemble de données. Les appels des méthodes First, Last, Next, Prior, MoveBy, Insert, Delete, Post, Requery et Resynch peuvent entraîner le déclenchement de cet événement. L'affectation ou la lecture d'un signet peut également déclencher cet événement.
DataSet est le composant ensemble de données ADO qui a déclenché l'événement OnMoveComplete. Ce composant ensemble de données contient également l'ensemble d'enregistrements en question.
Reason indique le type de déplacement qui a déclenché l'événement. Même si le type TEventReason contient davantage de constantes, la valeur de Reason pour un événement OnRecordChangeComplete est limité à : erRequery, erMove, erMoveFirst, erMoveNext, erMovePrevious et erMoveLast.
Error est un objet Error ADO. Pour davantage d'informations sur l'utilisation des objets Error ADO, consultez l'aide du SDK Microsoft Data Access. Le paramètre Error est défini uniquement si une erreur s'est produite lors de l'exécution de l'opération qui a déclenché l'événement. Dans ce cas, le paramètre EventStatus contient la valeur esErrorsOccured.
La valeur EventStatus (EventStatusEnum ADO) indique le succès ou l'échec de l'exécution de l'opération qui a déclenché cet événement.
Remarque : : Un pointeur de ligne de l'objet Recordset est distinct du pointeur d'enregistrement de son composant ensemble de données ADO. Il est possible que l'objet Recordset ADO génère des événements de déplacement de ligne sans que le composant ensemble de données ADO génère des événements BeforeScroll ou AfterScroll. Cela peut être dû à la mise à jour en arrière-plan et à la resynchronisation des enregistrements quand les données sont modifiées. L'événement OnMoveComplete est purement un événement de l'objet Recordset qui est indépendant de tous les événements de navigation d'enregistrements du composant ensemble de données.