Propriedade Application.EnableCancelKey (Excel)

Controla a forma como o Microsoft Excel processa as interrupções do utilizador Ctrl+Break (ou Esc ou Comando+Ponto Final) no procedimento em execução. XlEnableCancelKey de leitura/escrita.

Sintaxe

expressão. 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 utilizar xlDisabled, não existe forma de interromper um ciclo de tempo de execução ou outro código que não seja autoterminado. Da mesma forma, se utilizar xlErrorHandler , mas o processador de erros devolver sempre com a instrução Retomar , não existe forma de parar o código em execução.

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.