Evento Form.BeforeDelConfirm (Access)
O evento BeforeDelConfirm ocorre depois que o usuário excluir para o buffer um ou mais registros, mas antes do Microsoft Access exibe uma caixa de diálogo solicitando que o usuário confirmar as exclusões.
Sintaxe
expressão. BeforeDelConfirm (Cancelar, Resposta)
expressão Uma variável que representa um objeto Form.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Cancel | Obrigatório | Integer | A configuração determina se o evento BeforeDelConfirm ocorre. A definição do argumento de Cancel como True cancela o evento BeforeDelConfirm e impede que a caixa de diálogo Confirmar exclusão seja exibido. Se o evento for cancelado, os registros originais serão restaurados, mas o evento AfterDelConfirm ainda ocorre. Se Cancel for definido como True, o argumento Response será ignorado. Se Cancelar for definido como False (0), que é por padrão, o valor no argumento Resposta será usado pelo Access para determinar o tipo de resposta ao evento Delete . |
| Response | Obrigatório | Integer | Uma constante intrínseca que determina se o Access exibe a caixa de diálogo Excluir Confirmar perguntando se o registro deve ser excluído. acDataErrContinue continua sem exibir a caixa de diálogo Confirmar exclusão. A definição do argumento de Cancel como False e o argumento Response como acDataErrContinue permite que o Microsoft Access exclua registros sem avisar o usuário. acDataErrDisplay exibe a caixa de diálogo Confirmar exclusão. O valor padrão é acDataErrDisplay. |
Comentários
Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade BeforeDelConfirm como o nome da macro ou como [procedimento do evento].
Depois que um registro é excluído, ele é armazenado em um buffer temporário. Em um banco de dados access , o evento BeforeDelConfirm ocorre após o evento Delete (ou se você excluiu mais de um registro, depois que todos os registros são excluídos, com um evento Delete ocorrendo para cada registro), mas antes da caixa de diálogo Excluir Confirmar é exibida. Cancelar o evento BeforeDelConfirm restaura o registro ou registros do buffer e impede que a caixa de diálogo Confirmar exclusão seja exibido.
Em um banco de dados access, o evento AfterDelConfirm ocorre depois que um registro ou registros são realmente excluídos ou depois que uma exclusão ou exclusões são 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.
Se você cancelar o evento Excluir , o evento BeforeDelConfirm não ocorrerá e a caixa de diálogo Excluir Confirmar não será exibida.
Em um projeto access (.adp), o evento BeforeDelConfirm ocorre antes do evento Delete . 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.
Observação
[!OBSERVAçãO] O evento BeforeDelConfirm 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 BeforeDelConfirm 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.