Partager via


Événement TextBox.KeyUp (Access)

L'événement KeyUp se produit lorsque l'utilisateur relâche une touche pendant qu'un formulaire ou contrôle a le focus. Cet événement se produit également si vous envoyez une séquence de touches à un formulaire ou un contrôle à l'aide de l'action EnvoiTouches dans une macro ou l'instruction SendKeys dans Visual Basic.

Syntaxe

expression. KeyUp (KeyCode, Shift)

Expression Variable qui représente un objet TextBox .

Parameters

Nom Requis/Facultatif Type de données Description
KeyCode Obligatoire Integer Code clé, tel que vbKeyF1 (la touche F1) ou vbKeyHome (la clé d’accueil). Pour spécifier les codes de touche, utilisez les constantes intrinsèques présentées dans l'Explorateur d'objets. Vous pouvez empêcher un objet de recevoir une séquence de touches en définissant KeyCode sur 0.
Shift Obligatoire Integer État des touches Maj, Ctrl et Alt au moment de l’événement. Si vous devez tester l’argument Shift , vous pouvez utiliser l’une des constantes intrinsèques suivantes comme masques de bits :
  • acShiftMask Masque de bits de la touche Maj.

  • acCtrlMask Masque de bits de la touche Ctrl.

  • acAltMask Masque de bits de la touche Alt.

Remarques

Pour exécuter une macro ou une procédure événementielle lorsque ces événements se produisent, définissez la propriété OnKeyUp sur le nom de la macro ou [procédure événementielle].

Dans les deux cas, c'est l'objet actif qui reçoit les frappes de touches. Un formulaire ne peut être actif que s'il ne contient pas de contrôles ou si tous ses contrôles visibles sont désactivés.

Formulaire recevra également tous les événements de clavier, même ceux qui s'appliquent aux contrôles, si vous définissez la propriété KeyPreview du formulaire sur Oui. Dans ce cas, tous les événements de clavier ont d'abord lieu pour le formulaire et ensuite pour le contrôle qui a le focus. Vous pouvez répondre à des séquences de touches dans le formulaire, quels que soient les contrôle a le focus. Par exemple, vous pouvez souhaiter que la combinaison de touches Ctrl+X effectue toujours la même action sur un formulaire.

Si vous appuyez longuement sur une touche, les événements KeyDown et KeyPress alternativement à plusieurs reprises (KeyDown, KeyPress, KeyDown, KeyPress, etc.) jusqu’à ce que vous relâchez la touche, puis l’événement KeyUp se produit.

Bien que l'événement KeyUp se produise lorsque la plupart des touches sont enfoncées, il est généralement utilisé pour identifier ou distinguer :

  • Les touches de caractères étendus, telles que les touches de fonction.

  • Touches de navigation, telles que Accueil, Fin, PgUp, PgDn, Flèche haut, Flèche bas, Flèche droite, Flèche gauche et Tab.

  • Combinaisons de touches et de modificateurs de clavier standard (Touches Maj, Ctrl ou Alt).

  • Le pavé numérique et les touches à chiffre du clavier.

L'événement KeyUp ne se produit pas lorsque vous appuyez sur :

  • Touche Entrée si le formulaire comporte un bouton de commande pour lequel la propriété Default est définie sur Oui.

  • La touche Échap si le formulaire comporte un bouton de commande pour lequel la propriété Cancel est définie sur Oui.

L'événement KeyUp se produit après tout événement de contrôle déclenché par la frappe ou l'envoi de la clé. Si un code de touche provoque le focus passer d'un contrôle à un autre contrôle, l'événement KeyDown se produit pour le premier contrôle, tandis que les événements KeyPress et KeyUp se produisent pour le deuxième contrôle.

Pour savoir quel caractère ANSI correspond à la touche enfoncée, utilisez l'événement KeyPress.

Si une boîte de dialogue modale est affichée à la suite en appuyant sur ou envoyez une touche, les événements KeyDown et KeyPress se produisent, mais l'événement KeyUp ne se produit pas.

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.