Partager via

WillMove et MoveComplete, événements (ADO)

  • Article

L’événement WillMove est appelé avant qu’une opération en attente change la position actuelle dans l’objet Recordset. L’événement MoveComplete est appelé après la position actuelle dans les changements de Recordset.

Syntaxe

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset

Paramètres

adReason
Valeur EventReasonEnum qui spécifie la raison de cet événement. Sa valeur peut être adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove ou adRsnRequery.

pError
Un objet Error. Il décrit l’erreur qui s’est produite si la valeur adStatus est adStatusErrorsOccurred ; sinon le paramètre n’est pas défini.

adStatus
Valeur d’état EventStatusEnum.

Lorsque WillMove est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué l’événement a réussi. Il est défini sur adStatusCantDeny si cet événement ne peut pas demander l’annulation de l’opération en attente.

Lorsque MoveComplete est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué l’événement réussit ou sur adStatusErrorsOccurred si l’opération a échoué.

Avant que WillMove retourne un résultat, définissez ce paramètre sur adStatusCancel pour demander l’annulation de l’opération en attente, ou définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.

Avant que MoveComplete retourne un résultat, définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications suivantes.

pRecordset
Un objet Recordset. Le Recordset pour lequel cet événement s’est produit.

Notes

Un événement WillMove ou MoveComplete peut se produire suite aux opérations Recordset suivantes : Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew et Requery. Ces événements peuvent se produire en raison des propriétés suivantes : Filter, Index, Bookmark, AbsolutePage et AbsolutePosition. Ces événements se produisent également si un objet Recordset enfant a des événements Recordset connectés et que l’objet Recordset parent est déplacé.

Vous devez définir le paramètre adStatus sur adStatusUnwantedEvent pour chaque valeur adReason possible afin d’arrêter complètement les notifications d’événements pour tout événement qui inclut un paramètre adReason.

Voir aussi

Exemple de modèle d’événements ADO (VC ++)
Présentation rapide du gestionnaire d’événements ADO
Recordset, objet (ADO)