Événements WillMove et MoveComplete (ADO)
S’applique à : Access 2013, Office 2013
L'événement WillMove est appelé avant qu'une opération en attente modifie la position active dans l'objet Recordset. À l’inverse, l’événement MoveComplete est appelé après la modification de la position active dans l’objet Recordset.
Syntaxe
WillMoveadReason, adStatus, pRecordset
MoveCompleteadReason, pError, adStatus, pRecordset
Paramètres
| Paramètre | Description |
|---|---|
| adReason | Valeur EventReasonEnum indiquant la raison de cet événement. Les valeurs possibles sont adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove et adRsnRequery. |
| Perror | Objet Error. Dans le cas contraire, il n'est pas défini. |
| adStatus |
EventStatusEnum. Lorsque WillMove est appelé, ce paramètre est défini à adStatusOK si l'opération à l'origine de l'événement s'est déroulée correctement. Il est défini à adStatusCantDeny si cet événement ne peut pas demander l'annulation de l'opération en attente. Lorsque MoveComplete est appelé, ce paramètre a la valeur adStatusOK si l'opération à l'origine de l'événement s'est déroulée correctement ou adStatusErrorsOccurred si cette dernière a échoué. Avant que WillMove soit retourné, définissez ce paramètre à adStatusCancel pour demander l'annulation de l'opération en attente ou à adStatusUnwantedEvent pour éviter toute notification ultérieure. Avant que MoveComplete soit retourné, définissez ce paramètre à adStatusUnwantedEvent pour éviter toute notification ultérieure. |
| pRecordset | A Recordset object. The Recordset for which this event occurred. |
Remarques
Un événement WillMove ou MoveComplete peut se produire en raison des opérations Recordset suivantes :
Ces événements peuvent se produire en raison des propriétés suivantes :
Ils sont également générés si un objet Recordset enfant possède des événements relatifs à Recordset et que l'objet Recordset parent est déplacé.
Vous devez affecter au paramètre adStatus la valeur adStatusUnwantedEvent pour chaque valeur possible du paramètre adReason afin d'empêcher définitivement les notifications des événements comprenant un paramètre adReason.