Eventos WillChangeField e FieldChangeComplete (ADO)

Aplica-se ao: Access 2013, Office 2013

O evento WillChangeField é chamado antes que uma operação pendente altere o valor de um ou mais objetos Field em Recordset. O evento FieldChangeComplete é chamado depois que o valor de um ou mais objetos Field tiver sido alterado.

Sintaxe

WillChangeFieldcFields, Fields, adStatus, pRecordset

FieldChangeCompletecFields, Fields, pError, adStatus, pRecordset

Parâmetros

Parâmetro	Descrição
cFields	Um Long que indica o número de objetos Field em Fields.
Fields	Para WillChangeField, o parâmetro Fields é uma matriz de Variants que contém os objetos Field com os valores originais. Para FieldChangeComplete, o parâmetro Fields é uma matriz de Variants que contém os objetos Field com os valores alterados.
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 WillChangeField for chamado, esse parâmetro será definido como adStatusOK se a operação que provocou o evento tiver sido bem-sucedida. Será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação pendente. Quando FieldChangeComplete for cancelado, esse parâmetro será definido como adStatusOK se a operação que provocou o evento tiver sido bem-sucedida ou como adStatusErrorsOccurred se a operação tiver falhado. Antes que WillChangeField seja retornado, configure esse parâmetro como adStatusCancel para solicitar o cancelamento da operação pendente. Antes que FieldChangeComplete seja retornado, 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

O evento WillChangeField ou FieldChangeComplete pode ocorrer ao definir a propriedade Value e chamar o método Update com os parâmetros de matriz do valor e campo.