Propriedade Application.EnableCancelKey (Excel)

Controla como o Microsoft Excel lida com as interrupções do usuário Ctrl+Break (ou Esc ou Command+Ponto) para o procedimento de execução. Leitura/gravação XlEnableCancelKey.

Sintaxe

mais simples. EnableCancelKey

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

Comentários

XlEnableCancelKey pode ser uma destas constantes:

• xlDisabled. Interceptação das teclas de cancelamento completamente desativada.
• xlErrorHandler. A interrupção é enviada para o procedimento em execução como um erro, podendo ser interceptado por um tratamento de erros configurado com uma instrução On Error GoTo. O código de erro interceptável é 18.
• xlInterrupt. O procedimento atual é interrompido e o usuário pode depurá-lo ou finalizá-lo.

Use essa propriedade com muita cautela. Se você usar xlDisabled, não haverá como interromper um loop de fuga ou outro código que não seja de encerramento automático. Da mesma forma, se você usar xlErrorHandler , mas seu manipulador de erros sempre retornar usando a instrução Resume , não haverá como interromper o código descontrolado.

A propriedade EnableCancelKey é sempre redefinida como xlInterrupt quando o Microsoft Excel retorna ao estado ocioso e não existe um código em execução. Para interceptar ou desativar o cancelamento em seu procedimento, você precisa alterar explicitamente a propriedade EnableCancelKey toda vez que o procedimento for chamado.

Exemplo

Este exemplo mostra como você pode usar a propriedade EnableCancelKey para configurar um tratamento personalizado de cancelamento.

On Error GoTo handleCancel 
Application.EnableCancelKey = xlErrorHandler 
MsgBox "This may take a long time: press ESC to cancel" 
For x = 1 To 1000000 ' Do something 1,000,000 times (long!) 
 ' do something here 
Next x 
 
handleCancel: 
If Err = 18 Then 
 MsgBox "You cancelled" 
End If

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.