Compartilhar via


Evento Form.AfterDelConfirm (Access)

O evento AfterDelConfirm ocorre depois que o usuário confirma que as exclusões e os registros são realmente excluídos ou quando as exclusões são canceladas.

Sintaxe

expressão. AfterDelConfirm (Status)

expressão Uma variável que representa um objeto Form.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Status Obrigatório Integer Uma constante intrínseca que indica se um registro foi excluído. acDeleteOK indica que a exclusão foi bem-sucedida. acDeleteCancel indica que a exclusão foi cancelada no Visual Basic. acDeleteUserCancel indica que a exclusão foi cancelada pelo usuário.

Comentários

Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade AfterDelConfirm com o nome da macro ou como [procedimento do evento].

Depois que um registro for excluído, será armazenado em um buffer temporário.

Um banco de dados do Microsoft Access, o evento AfterDelConfirm ocorre depois que um ou mais registros forem realmente excluídos ou após uma ou mais exclusões forem canceladas. Se o evento BeforeDelConfirm não for cancelado, o evento AfterDelConfirm ocorre depois que a caixa de diálogo Confirmar exclusão é exibida. O evento AfterDelConfirm ocorrerá, mesmo se o evento BeforeDelConfirm será cancelado. O procedimento de evento AfterDelConfirm retorna informações de status sobre a exclusão. Por exemplo, você pode usar um macro ou procedimento de evento associado ao evento AfterDelConfirm para recalcular totais afetados pela exclusão de registros.

Em um projeto access (.adp), o evento AfterDelConfirm ocorre antes que um registro ou registros sejam realmente excluídos. Para evitar abrir transações desnecessárias no Microsoft SQL Server, o Access solicita que você confirme a exclusão antes de abrir a transação. Se você confirmar a exclusão, o Access abrirá uma transação no SQL Server, emitirá a instrução DELETE para excluir o registro ou registros e disparará o evento Delete do formulário. Se você escolher Não quando solicitado a confirmar a exclusão, o Access não abrirá uma transação no SQL Server para excluir o registro e não disparará o evento Delete do formulário.

Se você cancelar o evento Delete, o evento AfterDelConfirm não ocorrerá e a caixa de diálogo Confirmar exclusão não será exibida.

Observação

[!OBSERVAçãO] O evento AfterDelConfirm não ocorrerá e a caixa de diálogo Confirmar exclusão não será exibida se você desmarcar a caixa de seleção em ConfirmarAs alterações do registro na guia Editar da caixa de diálogo Opções do Access.

Executando uma macro ou um procedimento de evento quando ocorre o evento Delete, você pode impedir que um registro seja excluído ou permitir que um registro a ser excluído somente sob certas condições. Você também pode usar um evento de exclusão para exibir uma caixa de diálogo perguntando se o usuário deseja excluir um registro antes de serem excluído.

Depois de excluir o registro, o foco passa para o próximo registro após o registro excluído e o evento Atual para esse registro ocorre, seguido pelos eventos Enter e GotFocus para o primeiro controle nesse registro.

Em seguida, ocorre o evento BeforeDelConfirm , pouco antes do Access exibir a caixa de diálogo Excluir Confirmar solicitando que você confirme a exclusão. Após você responder à caixa de diálogo Confirmar ou cancelar a exclusão, o evento AfterDelConfirm ocorrerá.

Você pode excluir um ou mais registros por vez. O evento Delete ocorre após cada registro é excluído. Isso permite que você acesse os dados em cada registro antes de ele é realmente excluído e confirmar ou cancelar seletivamente cada exclusão no Excluir macro ou procedimento de evento. Quando você exclui mais de um registro, o evento Current para o registro após o último registro excluído e Enter e eventos GotFocus para o primeiro controle nesse registro não ocorrem até que todos os registros são excluídos. Em outras palavras, um evento Delete ocorre para cada registro selecionado, mas nenhum outro evento ocorre até que todos os registros selecionados sejam excluídos. O evento AfterDelConfirm também não ocorre até que todos os registros selecionados sejam excluídos.

Exemplo

O exemplo a seguir mostra como você pode usar o evento BeforeDelConfirm para suprimir a caixa de diálogo Confirmar exclusão e exibir uma caixa de diálogo personalizada quando um registro é excluído. Ele também mostra como você pode usar o AfterDelConfirm procedimento de evento para exibir uma mensagem indicando se a exclusão progrediu de maneira normal ou se foi cancelada no Visual Basic ou pelo usuário.

Private Sub Form_BeforeDelConfirm(Cancel As Integer, _ 
 Response As Integer) 
 ' Suppress default Delete Confirm dialog box. 
 Response = acDataErrContinue 
 ' Display custom dialog box. 
 If MsgBox("Delete this record?", vbOKCancel) = vbCancel Then 
 Cancel = True 
 End If 
End Sub 
 
Private Sub Form_AfterDelConfirm(Status As Integer) 
 Select Case Status 
 Case acDeleteOK 
 MsgBox "Deletion occurred normally." 
 Case acDeleteCancel 
 MsgBox "Programmer canceled the deletion." 
 Case acDeleteUserCancel 
 MsgBox "User canceled the deletion." 
 End Select 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.