Data.Win.ADODB.TCustomADODataSet.OnWillMove
Delphi
property OnWillMove: TRecordsetReasonEvent read FOnWillMove write FOnWillMove;
C++
__property TRecordsetReasonEvent OnWillMove = {read=FOnWillMove, write=FOnWillMove};
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 avant le déplacement du pointeur de ligne dans un ensemble d'enregistrements.
Ecrivez un gestionnaire d'événement OnWillMove pour effectuer des actions spécifiques avant que le pointeur de ligne ne soit 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 OnWillMove. 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 OnWillMove est limité à : erRequery, erMove, erMoveFirst, erMoveNext, erMovePrevious et erMoveLast.
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 OnWillMove 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.