Compartilhar via

Eventos WillMove e MoveComplete (ADO)

  • Artigo

O evento WillMove é chamado antes que uma operação pendente altere a posição atual no Recordset. O evento MoveComplete é chamado após a posição atual no Recordset ser alterada.

Sintaxe

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

Parâmetros

adReason
Um valor EventReasonEnum que especifica o motivo desse evento. O valor dele pode ser adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove ou adRsnRequery.

pError
Um objeto Error. Ele descreve o erro que ocorreu se o valor de adStatus é adStatusErrorsOccurred, caso contrário, o parâmetro não é definido.

adStatus
Um valor de status EventStatusEnum.

Quando WillMove é chamado, esse parâmetro é definido como adStatusOK se a operação que causou 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 causou o evento foi bem-sucedida ou como adStatusErrorsOccurred se a operação falhou.

Antes que WillMove seja retornado, defina esse parâmetro como adStatusCancel para solicitar o cancelamento da operação pendente ou defina esse parâmetro como adStatusUnwantedEvent para evitar notificações posteriores.

Antes de MoveComplete ser retornado, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações posteriores.

pRecordset
Um objeto Recordset. O Recordset para o qual esse evento ocorreu.

Comentários

Um evento WillMove ou MoveComplete poderá ocorrer devido às seguintes operações do Recordset: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew e Requery. Esses eventos podem ocorrer devido às seguintes propriedades: Filter, Index, Bookmark, AbsolutePage e AbsolutePosition. Esses eventos também ocorrerão se um Recordset filho tiver eventos Recordset conectados e o Recordset pai for movido.

Você precisa definir o parâmetro adStatus como adStatusUnwantedEvent para cada valor adReason possível, a fim de interromper completamente a notificação de eventos para qualquer evento que inclua um parâmetro adReason.

Consulte Também

Exemplo do modelo de eventos ADO (VC++)
Resumo do manipulador de eventos ADO
Objeto Recordset (ADO)