Événement Report.KeyPress (Access)

L'événement KeyPress se produit lorsque l'utilisateur appuie puis relâche une touche ou une combinaison de touches correspondant à un code ANSI pendant qu'un état est activé. Cet événement se produit également si vous envoyez une séquence de touches ANSI à un état à l'aide de l'action EnvoiTouches dans une macro ou l'instruction SendKeys dans Visual Basic.

Syntaxe

expression. KeyPress (KeyAscii)

Expression Variable qui représente un objet Report .

Parameters

Nom	Requis/Facultatif	Type de données	Description
KeyAscii	Obligatoire	Entier	Renvoie un code de touche ANSI numérique. L'argument KeyAscii est passé par référence ; sa modification entraîne l'envoi d'un caractère différent à l'objet. Régler l'argument KeyAscii sur 0 annule la pression de touches, de sorte que l'objet ne sait pas qu'une touche a été pressée.

Remarques

Pour exécuter une macro ou une procédure événementielle lorsque cet événement se produit, définissez la propriété OnKeyPress sur le nom de la macro ou [procédure événementielle].

Un rapport 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 rapport sur Oui. Dans ce cas, tous les événements de clavier ont d'abord lieu pour le rapport, et ensuite pour le contrôle qui a le focus. Vous pouvez répondre à des séquences de touches dans le rapport, 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 rapport.

Si vous appuyez de façon longue sur une touche ANSI, les événements KeyDown et KeyPress alternent de façon répétée (KeyDown, KeyPress, KeyDown, KeyPress, etc.) jusqu’à ce que vous relâchez la touche, puis l’événement KeyUp se produit.

Un événement KeyPress peut impliquer n’importe quel caractère clavier imprimable, la touche Ctrl combinée à un caractère de l’alphabet standard ou un caractère spécial, et la touche Entrée ou Retour arrière. Utilisez les procédures événementielles KeyDown et KeyUp pour gérer les frappes de touches non reconnues par l’événement KeyPress , telles que les touches de fonction, les touches de navigation et toutes les combinaisons de ces touches avec des modificateurs clavier (touches Alt, Maj ou Ctrl). Contrairement aux événements KeyDown et KeyUp, l'événement KeyPress n'indique pas l'état physique du clavier ; au lieu de cela, elle indique le caractère ANSI correspondant à la touche enfoncée ou combinaisons de touches.

L'événement KeyPress interprète la majuscule et la minuscule de chaque caractère en tant que codes de touche distincts et, par conséquent, en tant que caractères distincts.

Remarque

La touche Retour arrière fait partie du jeu de caractères ANSI, mais pas la touche Supprimer. Si vous supprimez un caractère dans un contrôle à l’aide de la touche Retour arrière, vous provoquez un événement KeyPress ; si vous utilisez la touche Supprimer, ce n’est pas le cas.

Les événements KeyDown et KeyPress se produisent lorsque vous appuyez sur la touche ou que vous envoyez une touche ANSI. 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.

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.