Propriété Application.EnableCancelKey (Excel)

  • Article

Contrôle la façon dont Microsoft Excel gère les interruptions d’utilisateur Ctrl+Pause (ou Échap ou Commande+Période) dans la procédure en cours d’exécution. En lecture/écriture XlEnableCancelKey.

Syntaxe

expression. EnableCancelKey

expressionUne variable qui représente un objetApplication.

Remarques

XlEnableCancelKey peut être l’une des constantes suivantes :

  • xlDisabled. L'interception des annulations est complètement désactivée.
  • xlErrorHandler. L’interruption est envoyée à la procédure en cours d’exécution en tant qu’erreur, interceptable par un gestionnaire d’erreurs configuré avec une instruction On Error GoTo . Le code de cette erreur pouvant être interceptée est le 18.
  • xlInterrupt. La procédure en cours est interrompue et l'utilisateur peut procéder au débogage et achever la procédure.

Soyez prudent lorsque vous utilisez cette propriété. Si vous utilisez xlDisabled, il n’existe aucun moyen d’interrompre une boucle d’exécution ou un autre code qui ne se termine pas automatiquement. De même, si vous utilisez xlErrorHandler mais que votre gestionnaire d’erreurs retourne toujours à l’aide de l’instruction Resume , il n’existe aucun moyen d’arrêter le code d’exécution.

La propriété EnableCancelKey reprend toujours la valeur xlInterrupt chaque fois que Microsoft Excel redevient inactif et qu'aucun code n'est exécuté. Pour intercepter ou désactiver l'annulation dans votre procédure, vous devez modifier explicitement la propriété EnableCancelKey chaque fois que la procédure est appelée.

Exemple

Cet exemple montre comment utiliser la propriété EnableCancelKey pour installer un gestionnaire d'annulation personnalisé.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.