Compartilhar via

Propriedade Application.EnableCancelKey (Excel)

  • Artigo

Controla como o Microsoft Excel lida com interrupções de usuário ctrl+break (ou Esc ou Command+Period) para o procedimento em execução. XlEnableCancelKey de leitura/gravação.

Sintaxe

expressão. EnableCancelKey

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

Comentários

XlEnableCancelKey pode ser uma dessas 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 desgovernado ou outro código que não seja autoternizado. Da mesma forma, se você usar xlErrorHandler , mas o manipulador de erros sempre retornar usando a instrução Retomar , não haverá como parar 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.