Eventos WillMove e MoveComplete (ADO)
Aplica-se ao: Access 2013, Office 2013
O evento WillMove é chamado antes que a operação pendente altere a sua posição atual no Recordset. O evento MoveComplete é chamado depois da alteração da posição atual no Recordset.
Sintaxe
WillMoveadReason, adStatus, pRecordset
MoveCompleteadReason, pError, adStatus, pRecordset
Parâmetros
| Parâmetro | Descrição |
|---|---|
| adReason | Um valor EventReasonEnum que especifica a razão para esse evento. Seu valor pode ser adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove ou adRsnRequery. |
| pError | Um objeto Error. Descreve o erro ocorrido se o valor de adStatus for adStatusErrorsOccurred; caso contrário, não será definido. |
| adStatus |
EventStatusEnum. Quando WillMove é chamado, esse parâmetro é definido como adStatusOK se a operação que gerou o evento foi bem-sucedida. Ele será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação pendente. Quando MoveComplete é chamado, esse parâmetro é definido como adStatusOK se a operação que gerou o evento foi bem-sucedida, ou como adStatusErrorsOccurred se a operação falhar. Antes do retorno de WillMove, defina esse parâmetro como adStatusCancel, para solicitar o cancelamento da operação pendente, ou como adStatusUnwantedEvent para evitar notificações subsequentes. Antes do retorno de MoveComplete, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes. |
| pRecordset | Um objeto Recordset. O Recordset para o qual esse evento ocorreu. |
Comentários
Um evento WillMove ou MoveComplete pode ocorrer devido às seguintes operações do Recordset :
Esses eventos podem ocorrer devido às seguintes propriedades:
Esses eventos também ocorrerão se um Recordset filho tiver eventos Recordset conectados e se o Recordset pai for movido.
Você deve definir o parâmetro adStatus como adStatusUnwantedEvent para cada valor adReason possível para parar completamente a notificação de evento para qualquer evento que inclua um parâmetro adReason.