Partager via

Événements WillMove et MoveComplete (ADO)

  • Article

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

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, adRsnMoveou adRsnRequery.

pError
Objet Error. Il décrit l’erreur qui s’est produite si la valeur de 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 à l’origine de l’événement a réussi. Elle est définie 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 à l’origine de l’événement a réussi ou adStatusErrorsOccurred si l’opération a échoué.

Avant WillMove retourne, 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 suivantes.

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

pRecordset
Objet Recordset. Le jeu d’enregistrements pour lequel cet événement s’est produit.

Remarques

Un événement WillMove ou MoveComplete peut se produire en raison des opérations de recordset suivantes : Ouvrir, Déplacer, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNewet Requery. Ces événements peuvent se produire en raison des propriétés suivantes : Filtre, Index, Signet, AbsolutePageet AbsolutePosition. Ces événements se produisent également si un jeu d’enregistrements enfant a recordset événements connectés et que le jeu d’enregistrements 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 la notification d’événement pour tout événement qui inclut un paramètre adReason.

Voir aussi

modèle d’événements ADO (VC++)
résumé du gestionnaire d’événements ADO
objet Recordset (ADO)