Partager via

Entrée du clavier

  • Article

Cette section décrit comment le système génère une entrée clavier et comment une application reçoit et traite cette entrée.

Dans cette section

Nom Description
à propos des d’entrée au clavier Traite de l’entrée du clavier.
à l’aide du d’entrée clavier Couvre les tâches associées à l’entrée du clavier.
informations de référence sur l’entrée au clavier Contient la référence de l’API.

Fonctions

Nom Description
activateKeyboardLayout Définit l’identificateur des paramètres régionaux d’entrée (anciennement appelé handle de disposition du clavier) pour le thread appelant ou le processus actuel. L’identificateur des paramètres régionaux d’entrée spécifie des paramètres régionaux ainsi que la disposition physique du clavier.
BlockInput Bloque les événements d’entrée de clavier et de souris d’atteindre les applications.
enableWindow Active ou désactive l’entrée de la souris et du clavier dans la fenêtre ou le contrôle spécifié. Lorsque l’entrée est désactivée, la fenêtre ne reçoit pas d’entrée telle que les clics de souris et les appuis sur les touches. Lorsque l’entrée est activée, la fenêtre reçoit toutes les entrées.
getActiveWindow Récupère le handle de fenêtre dans la fenêtre active attachée à la file d’attente de messages du thread appelant.
GetAsyncKeyState Détermine si une touche est vers le haut ou le bas au moment où la fonction est appelée, et si la touche a été enfoncée après un appel précédent pour GetAsyncKeyState.
GetFocus Récupère le handle dans la fenêtre qui a le focus clavier, si la fenêtre est attachée à la file d’attente de messages du thread appelant.
GetKeyboardLayout Récupère l’identificateur de paramètres régionaux d’entrée actif (anciennement appelé disposition du clavier) pour le thread spécifié. Si le paramètre idThread est égal à zéro, l’identificateur de paramètres régionaux d’entrée du thread actif est retourné.
GetKeyboardLayoutList Récupère les identificateurs de paramètres régionaux d’entrée (anciennement appelés handles de disposition du clavier) correspondant à l’ensemble actuel de paramètres régionaux d’entrée dans le système. La fonction copie les identificateurs dans la mémoire tampon spécifiée.
GetKeyboardLayoutName Récupère le nom de l’identificateur de paramètres régionaux d’entrée actif (anciennement appelé disposition du clavier).
GetKeyboardState Copie l’état des clés virtuelles 256 dans la mémoire tampon spécifiée.
GetKeyNameText Récupère une chaîne qui représente le nom d’une clé.
GetKeyState Récupère l’état de la clé virtuelle spécifiée. L’état spécifie si la touche est haut, bas ou bascule (activée, désactivée à chaque fois que la touche est enfoncée).
GetLastInputInfo Récupère l’heure de la dernière entrée.
IsWindowEnabled Détermine si la fenêtre spécifiée est activée pour l’entrée de la souris et du clavier.
loadKeyboardLayout Charge un nouvel identificateur de paramètres régionaux d’entrée (anciennement appelé disposition du clavier) dans le système. Plusieurs identificateurs de paramètres régionaux d’entrée peuvent être chargés à la fois, mais un seul par processus est actif à la fois. Le chargement de plusieurs identificateurs de paramètres régionaux d’entrée permet de basculer rapidement entre eux.
MapVirtualKey Convertit (mappe) un code de clé virtuelle en code d’analyse ou valeur de caractère, ou traduit un code d’analyse en code de clé virtuelle.
Pour spécifier un handle vers la disposition du clavier à utiliser pour traduire le code spécifié, utilisez la fonction MapVirtualKeyEx.
MapVirtualKeyEx Mappe un code de clé virtuelle en code d’analyse ou valeur de caractère, ou traduit un code d’analyse en code de clé virtuelle. La fonction traduit les codes à l’aide de la langue d’entrée et d’un identificateur de paramètres régionaux d’entrée.
oemKeyScan Mappe les codes OEMASCII 0 à 0x0FF dans les codes d’analyse OEM et les états de décalage. La fonction fournit des informations qui permettent à un programme d’envoyer du texte OEM à un autre programme en simulant l’entrée du clavier.
RegisterHotKey Définit une clé chaude à l’échelle du système.
SendInput Synthétise les séquences de touches, les mouvements de la souris et les clics de bouton.
SetActiveWindow Active une fenêtre. La fenêtre doit être attachée à la file d’attente de messages du thread appelant.
SetFocus Définit le focus clavier sur la fenêtre spécifiée. La fenêtre doit être attachée à la file d’attente de messages du thread appelant.
SetKeyboardState Copie un tableau de touches de 256 octets dans la table d’état d’entrée du clavier du thread appelant. Il s’agit de la même table accessible par les fonctions GetKeyboardState et GetKeyState. Les modifications apportées à ce tableau n’affectent pas l’entrée du clavier à tout autre thread.
ToAscii Convertit le code de touche virtuelle et l’état du clavier spécifiés en caractères ou caractères correspondants. La fonction traduit le code à l’aide de la langue d’entrée et de la disposition du clavier physique identifiée par la poignée de disposition du clavier.
Pour spécifier un handle à la disposition du clavier à utiliser pour traduire le code spécifié, utilisez la fonction ToAsciiEx.
ToAsciiEx Convertit le code de touche virtuelle et l’état du clavier spécifiés en caractères ou caractères correspondants. La fonction traduit le code à l’aide de la langue d’entrée et de la disposition du clavier physique identifiée par l’identificateur de paramètres régionaux d’entrée.
ToUnicode Traduit le code de touche virtuelle et l’état du clavier spécifiés en caractères Unicode ou caractères Unicode correspondants.
Pour spécifier un handle à la disposition du clavier à utiliser pour traduire le code spécifié, utilisez la fonction ToUnicodeEx.
ToUnicodeEx Traduit le code de touche virtuelle et l’état du clavier spécifiés en caractères Unicode ou caractères Unicode correspondants.
unloadKeyboardLayout Décharge un identificateur de paramètres régionaux d’entrée (anciennement appelé disposition du clavier).
DésinscrireHotKey Libère une clé chaude précédemment inscrite par le thread appelant.
VkKeyScanEx Traduit un caractère en code de clé virtuelle correspondante et en état de décalage. La fonction traduit le caractère à l’aide de la langue d’entrée et de la disposition du clavier physique identifiée par l’identificateur de paramètres régionaux d’entrée.

Les fonctions suivantes sont obsolètes.

Fonction Description
GetKBCodePage Récupère la page de codes active.
keybd_event Synthétise une séquence de touches. Le système peut utiliser une telle séquence de touches synthétisée pour générer un message WM_KEYUP ou WM_KEYDOWN. Le gestionnaire d’interruptions du pilote clavier appelle la fonction keybd_event.
VkKeyScan Traduit un caractère en code de touche virtuelle correspondante et en état de décalage pour le clavier actuel.

Messages

Nom Description
WM_GETHOTKEY Détermine la touche chaude associée à une fenêtre.
WM_SETHOTKEY Associe une touche chaude à la fenêtre. Lorsque l’utilisateur appuie sur la touche chaude, le système active la fenêtre.

Notifications

Nom Description
WM_ACTIVATE Envoyé à la fois à la fenêtre activée et à la fenêtre désactivée. Si les fenêtres utilisent la même file d’attente d’entrée, le message est envoyé de façon synchrone, d’abord à la procédure de fenêtre de la fenêtre de niveau supérieur en cours de désactivation, puis à la procédure de fenêtre de niveau supérieur activée. Si les fenêtres utilisent des files d’attente d’entrée différentes, le message est envoyé de façon asynchrone, de sorte que la fenêtre est activée immédiatement.
WM_APPCOMMAND Avertit une fenêtre que l’utilisateur a généré un événement de commande d’application, par exemple, en cliquant sur un bouton de commande d’application à l’aide de la souris ou en tapant une touche de commande d’application sur le clavier.
WM_CHAR Publié dans la fenêtre avec le focus clavier lorsqu’un message WM_KEYDOWN est traduit par la fonction TranslateMessage. Le message WM_CHAR contient le code caractère de la touche qui a été enfoncée.
WM_DEADCHAR Publié dans la fenêtre avec le focus clavier lorsqu’un message WM_KEYUP est traduit par la fonction TranslateMessage. WM_DEADCHAR spécifie un code de caractère généré par une clé morte. Une clé morte est une clé qui génère un caractère, tel que l’umlaut (point double), combiné à un autre caractère pour former un caractère composite. Par exemple, le caractère umlaut-O () est généré en tapant la clé morte pour le caractère umlaut, puis en tapant la touche O.
WM_HOTKEY Publié lorsque l’utilisateur appuie sur une touche chaude inscrite par la fonctionRegisterHotKey. Le message est placé en haut de la file d’attente de messages associée au thread qui a inscrit la clé chaude.
WM_KEYDOWN Publié dans la fenêtre avec le focus clavier lorsqu’une touche non système est enfoncée. Une touche non système est une touche qui est enfoncée lorsque la touche ALT n’est pas enfoncée.
WM_KEYUP Publié dans la fenêtre avec le focus clavier lorsqu’une touche non système est libérée. Une touche non système est une touche enfoncée lorsque la touche Alt n’est pas enfoncée, ou une touche clavier enfoncée lorsqu’une fenêtre a le focus clavier.
WM_KILLFOCUS Envoyé à une fenêtre immédiatement avant de perdre le focus clavier.
WM_SETFOCUS Envoyé à une fenêtre après avoir obtenu le focus clavier.
WM_SYSDEADCHAR Envoyé à la fenêtre avec le focus clavier lorsqu’un message WM_SYSKEYDOWN est traduit par la fonction TranslateMessage. WM_SYSDEADCHAR spécifie le code de caractère d’une touche morte système, une touche morte enfoncée tout en maintenant enfoncée la touche Alt.
WM_SYSKEYDOWN Publié dans la fenêtre avec le focus clavier lorsque l’utilisateur appuie sur la touche F10 (qui active la barre de menus) ou maintient la touche Alt enfoncée, puis appuie sur une autre touche. Il se produit également lorsqu’aucune fenêtre n’a actuellement le focus clavier ; dans ce cas, le message WM_SYSKEYDOWN est envoyé à la fenêtre active. La fenêtre qui reçoit le message peut faire la distinction entre ces deux contextes en vérifiant le code de contexte dans le paramètre lParam.
WM_SYSKEYUP Publié dans la fenêtre avec le focus clavier lorsque l’utilisateur relâche une touche enfoncée pendant que la touche ALT a été enfoncée. Il se produit également lorsqu’aucune fenêtre n’a actuellement le focus clavier ; dans ce cas, le message WM_SYSKEYUP est envoyé à la fenêtre active. La fenêtre qui reçoit le message peut faire la distinction entre ces deux contextes en vérifiant le code de contexte dans le paramètre lParam.
WM_UNICHAR Publié dans la fenêtre avec le focus clavier lorsqu’un message WM_KEYDOWN est traduit par la fonction TranslateMessage. Le message WM_UNICHAR contient le code caractère de la touche qui a été enfoncée.

Structures

Nom Description
HARDWAREINPUT Contient des informations sur un message simulé généré par un appareil d’entrée autre qu’un clavier ou une souris.
INPUT Contient des informations utilisées pour synthétiser les événements d’entrée tels que les séquences de touches, le mouvement de la souris et les clics de souris.
KEYBDINPUT Contient des informations sur un événement de clavier simulé.
LASTINPUTINFO Contient l’heure de la dernière entrée.
MOUSEINPUT Contient des informations sur un événement de souris simulé.

Constantes

Nom Description
codes Virtual-Key Noms de constantes symboliques, valeurs hexadécimales et équivalents souris ou clavier pour les codes de touche virtuelle utilisés par le système. Les codes sont répertoriés dans l’ordre numérique.

Voir aussi