Vue d’ensemble des entrées du clavier

Les applications doivent accepter les entrées utilisateur à partir du clavier, ainsi que de la souris. Une application reçoit une entrée du clavier sous la forme de messages publiés dans ses fenêtres.

Modèle d’entrée du clavier

Le système fournit une prise en charge du clavier indépendant de l’appareil pour les applications en installant un pilote de périphérique de clavier approprié pour le clavier actuel. Le système fournit une prise en charge du clavier indépendant de la langue à l’aide de la disposition de clavier spécifique à la langue actuellement sélectionnée par l’utilisateur ou l’application. Le pilote de périphérique de clavier reçoit des codes d’analyse du clavier, qui sont envoyés à la disposition du clavier où ils sont traduits en messages et publiés dans les fenêtres appropriées de votre application.

Chaque touche d’un clavier est associée à une valeur unique appelée code d’analyse, un identificateur dépendant de l’appareil pour la touche du clavier. Un clavier génère deux codes d’analyse lorsque l’utilisateur tape une touche : l’un lorsque l’utilisateur appuie sur la touche et l’autre lorsque l’utilisateur relâche la touche.

Le pilote de périphérique de clavier interprète un code d’analyse et le traduit (mappe) en code de touche virtuelle, une valeur indépendante de l’appareil définie par le système qui identifie l’objectif d’une clé. Après avoir traduit un code d’analyse, la disposition du clavier crée un message qui inclut le code d’analyse, le code de touche virtuelle et d’autres informations sur la séquence de touche, puis place le message dans la file d’attente des messages système. Le système supprime le message de la file d’attente des messages système et le publie dans la file d’attente des messages du thread approprié. Enfin, la boucle de message du thread supprime le message et le transmet à la procédure de fenêtre appropriée pour le traitement. La figure suivante illustre le modèle d’entrée du clavier.

modèle de traitement des entrées du clavier

Focus et activation du clavier

Le système publie des messages clavier dans la file d’attente des messages du thread de premier plan qui a créé la fenêtre avec le focus clavier. Le focus clavier est une propriété temporaire d’une fenêtre. Le système partage le clavier entre toutes les fenêtres de l’écran en déplaçant le focus clavier, selon les instructions de l’utilisateur, d’une fenêtre à l’autre. La fenêtre qui a le focus clavier reçoit (à partir de la file d’attente de messages du thread qui l’a créée) tous les messages clavier jusqu’à ce que le focus passe à une autre fenêtre.

Un thread peut appeler la fonction GetFocus pour déterminer laquelle de ses fenêtres (le cas échéant) a actuellement le focus clavier. Un thread peut donner au clavier le focus sur l’une de ses fenêtres en appelant la fonction SetFocus. Lorsque le focus du clavier passe d’une fenêtre à l’autre, le système envoie un message WM_KILLFOCUS à la fenêtre qui a perdu le focus, puis envoie un message WM_SETFOCUS à la fenêtre qui a obtenu le focus.

Le concept de focus clavier est lié à celui de la fenêtre active. La fenêtre active est la fenêtre de niveau supérieur avec laquelle l’utilisateur travaille actuellement. La fenêtre avec le focus clavier est soit la fenêtre active, soit une fenêtre enfant de la fenêtre active. Pour aider l’utilisateur à identifier la fenêtre active, le système la place en haut de l’ordre Z et met en surbrillance sa barre de titre (le cas échéant) et sa bordure.

L’utilisateur peut activer une fenêtre de niveau supérieur en cliquant dessus, en la sélectionnant à l’aide de la combinaison de touches ALT+TAB ou ALT+Échap, ou en la sélectionnant dans la liste des tâches. Un thread peut activer une fenêtre de niveau supérieur à l’aide de la fonction SetActiveWindow. Il peut déterminer si une fenêtre de niveau supérieur qu’il a créée est active à l’aide de la fonction GetActiveWindow.

Lorsqu’une fenêtre est désactivée et qu’une autre est activée, le système envoie le message WM_ACTIVATE. Le mot d’ordre faible du paramètre wParam est égal à zéro si la fenêtre est désactivée et non nul si elle est activée. Lorsque la procédure de fenêtre par défaut reçoit le message WM_ACTIVATE, elle définit le focus clavier sur la fenêtre active.

Pour empêcher les événements d’entrée du clavier et de la souris d’atteindre les applications, utilisez BlockInput. Notez que la fonction BlockInput n’interfère pas avec la table d’état d’entrée asynchrone du clavier. Cela signifie que l’appel de la fonction SendInput alors que l’entrée est bloquée modifie la table d’état d’entrée asynchrone du clavier.

Messages de frappe

En appuyant sur une touche, un message WM_KEYDOWN ou WM_SYSKEYDOWN est placé dans la file d’attente de messages de thread attachée à la fenêtre qui a le focus clavier. La libération d’une clé entraîne la mise en place d’un message WM_KEYUP ou WM_SYSKEYUP dans la file d’attente.

Les messages d’activation et de désactivation des touches se produisent généralement par paires, mais si l’utilisateur conserve une touche enfoncée suffisamment longtemps pour démarrer la fonctionnalité de répétition automatique du clavier, le système génère un certain nombre de messages WM_KEYDOWN ou WM_SYSKEYDOWN à la suite. Il génère ensuite un seul message WM_KEYUP ou WM_SYSKEYUP lorsque l’utilisateur relâche la touche.

Cette section couvre les sujets suivants :

Séquences de touches système et non système

Le système fait une distinction entre les séquences de touches système et les séquences de touches non système. Les séquences de touches système produisent des messages de frappe système, WM_SYSKEYDOWN et WM_SYSKEYUP. Les séquences de touches non système produisent des messages de frappe non système, WM_KEYDOWN et WM_KEYUP.

Si votre procédure de fenêtre doit traiter un message de frappe système, assurez-vous qu’après avoir traité le message, la procédure le transmet à la fonction DefWindowProc. Sinon, toutes les opérations système impliquant la touche ALT sont désactivées chaque fois que la fenêtre a le focus clavier. Autrement dit, l’utilisateur ne pourra pas accéder aux menus de la fenêtre ou au menu Système, ou utiliser la combinaison ALT+Échap ou ALT+TAB pour activer une autre fenêtre.

Les messages de frappe système sont principalement destinés au système plutôt qu’à une application. Le système les utilise pour fournir son interface clavier intégrée aux menus et pour permettre à l’utilisateur de contrôler la fenêtre active. Les messages de frappe système sont générés lorsque l’utilisateur tape une touche en combinaison avec la touche ALT, ou lorsque l’utilisateur tape et qu’aucune fenêtre n’a le focus clavier (par exemple, lorsque l’application active est réduite). Dans ce cas, les messages sont publiés dans la file d’attente des messages attachée à la fenêtre active.

Les messages de frappe non système sont destinés à être utilisés par les fenêtres d’application ; la fonction DefWindowProc n’en fait rien. Une procédure de fenêtre peut ignorer tous les messages de frappe non système dont elle n’a pas besoin.

Description des codes de touche virtuelle

Le paramètre wParam d’un message de frappe contient le code de touche virtuelle de la touche qui a été enfoncée ou relâchée. Une procédure de fenêtre traite ou ignore un message de frappe, en fonction de la valeur du code de touche virtuelle.

Une procédure de fenêtre classique traite uniquement un petit sous-ensemble des messages de frappe qu’elle reçoit et ignore le reste. Par exemple, une procédure de fenêtre peut traiter uniquement les messages de frappe WM_KEYDOWN et uniquement ceux qui contiennent des codes de touche virtuelle pour les touches de déplacement du curseur, les touches maj (également appelées touches de contrôle) et les touches de fonction. Une procédure de fenêtre classique ne traite pas les messages de frappe à partir de touches de caractères. Au lieu de cela, il utilise la fonction TranslateMessage pour convertir le message en messages de caractères. Pour plus d’informations sur TranslateMessage et les messages de caractères, consultez Messages de caractères.

Indicateurs de message de frappe

Le paramètre lParam d’un message de frappe contient des informations supplémentaires sur la séquence de touches qui a généré le message. Ces informations incluent le nombre de répétitions, le code d’analyse, l’indicateur de touche étendue, le code de contexte, l’indicateur d’état de touche précédente et l’indicateur d’état de transition. L’illustration suivante montre les emplacements de ces indicateurs et valeurs dans le paramètre lParam.

emplacements des indicateurs et des valeurs dans le paramètre lparam d’un message de frappe

Une application peut utiliser les valeurs suivantes pour obtenir les indicateurs de séquences de touches à partir d’un mot d’ordre élevé du lParam.

Valeur Description
KF_EXTENDED
0x0100
Manipule l’indicateur de touche étendue.
KF_DLGMODE
0x0800
Manipule l’indicateur de mode de dialogue, qui indique si une boîte de dialogue est active.
KF_MENUMODE
0x1000
Manipule l’indicateur de mode de menu, qui indique si un menu est actif.
KF_ALTDOWN
0x2000
Manipule l’indicateur de code de contexte.
KF_REPEAT
0x4000
Manipule l’indicateur d’état de touche précédente.
KF_UP
0x8000
Manipule l’indicateur d’état de transition.

Exemple de code :

case WM_KEYDOWN:
case WM_KEYUP:
case WM_SYSKEYDOWN:
case WM_SYSKEYUP:
{
    WORD vkCode = LOWORD(wParam);                                 // virtual-key code
    
    WORD keyFlags = HIWORD(lParam);

    WORD scanCode = LOBYTE(keyFlags);                             // scan code
    BOOL isExtendedKey = (keyFlags & KF_EXTENDED) == KF_EXTENDED; // extended-key flag, 1 if scancode has 0xE0 prefix
    
    if (isExtendedKey)
        scanCode = MAKEWORD(scanCode, 0xE0);

    BOOL wasKeyDown = (keyFlags & KF_REPEAT) == KF_REPEAT;        // previous key-state flag, 1 on autorepeat
    WORD repeatCount = LOWORD(lParam);                            // repeat count, > 0 if several keydown messages was combined into one message

    BOOL isKeyReleased = (keyFlags & KF_UP) == KF_UP;             // transition-state flag, 1 on keyup

    // if we want to distinguish these keys:
    switch (vkCode)
    {
    case VK_SHIFT:   // converts to VK_LSHIFT or VK_RSHIFT
    case VK_CONTROL: // converts to VK_LCONTROL or VK_RCONTROL
    case VK_MENU:    // converts to VK_LMENU or VK_RMENU
        vkCode = LOWORD(MapVirtualKeyW(scanCode, MAPVK_VSC_TO_VK_EX));
        break;
    }

    // ...
}
break;

Nombre de répétitions

Vous pouvez vérifier le nombre de répétitions pour déterminer si un message de frappe représente plusieurs séquences de touches. Le système incrémente le nombre lorsque le clavier génère des messages WM_KEYDOWN ou WM_SYSKEYDOWN plus rapidement qu’une application ne peut les traiter. Cela se produit souvent lorsque l’utilisateur maintient une touche suffisamment longtemps pour démarrer la fonctionnalité de répétition automatique du clavier. Au lieu de remplir la file d’attente de messages système avec les messages de désactivation de touches résultants, le système combine les messages en un seul message d’activation de touches et incrémente le nombre de répétitions. Le relâchement d’une touche ne peut pas démarrer la fonctionnalité de répétition automatique, de sorte que le nombre de répétitions pour les messages WM_KEYUP et WM_SYSKEYUP est toujours défini sur 1.

Codes d’analyse

Diagramme d’un clavier de type 4 avec les emplacements des touches pour chaque touche.

Le code d’analyse est la valeur que le système génère lorsque l’utilisateur appuie sur une touche. Il s’agit d’une valeur qui identifie la touche enfoncée quelle que soit la disposition du clavier active, par opposition au caractère représenté par la touche. Une application ignore généralement les codes d’analyse. Au lieu de cela, il utilise les codes de clé virtuelle pour interpréter les messages de séquence de touches.

Les claviers modernes utilisent la spécification HID (Human Interface Devices) pour communiquer avec un ordinateur. Le pilote de clavier convertit les valeurs d’utilisation HID signalées envoyées à partir du clavier pour analyser les сodes et les transmet aux applications.

Notes

Bien que les codes de touches virtuelles soient généralement plus utiles pour les applications de bureau, les codes d’analyse peuvent être nécessaires dans des cas spécifiques lorsque vous devez savoir quelle touche est enfoncée, quelle que soit la disposition du clavier actuelle. Par exemple, les liaisons de touches WASD (W est haut, A à gauche, S est vers le bas et D à droite) pour les jeux, qui garantissent une formation de touches cohérente dans les dispositions de clavier US QWERTY ou Français AZERTY .

Le tableau suivant répertorie l’ensemble des codes d’analyse actuellement reconnus par Windows. Page /d’utilisation HIDID d’utilisation HID/Les valeurs nom d’utilisation HID font référence au document Tables d’utilisation HID. Les valeurs de l’emplacement de la clé font référence à l’image clavier précédente.

Le code Scan 1 Make est remis dans WM_KEYDOWN/WM_KEYUP/WM_SYSKEYDOWN/WM_SYSKEYUP et WM_INPUT messages.

Nom de la page d’utilisation HID Nom d’utilisation HID Page d’utilisation HID ID d’utilisation HID Scan 1 Make Emplacement de la clé
Bureau générique Mise hors tension du système 0x0001 0x0081 0xE05E
Bureau générique Veille système 0x0001 0x0082 0xE05F
Bureau générique Mise en éveil du système 0x0001 0x0083 0xE063
Clavier/Clavier ErrorRollOver 0x0007 0x0001 0x00FF
Clavier/Clavier POSTFail 0x0007 0x0002 0x00FC
Clavier/Clavier Clavier A 0x0007 0x0004 0x001E 31
Clavier/Clavier Clavier B 0x0007 0x0005 0x0030 50
Clavier/Clavier Clavier C 0x0007 0x0006 0x002E 48
Clavier/Clavier Clavier D 0x0007 0x0007 0x0020 33
Clavier/Clavier Clavier E 0x0007 0x0008 0x0012 19
Clavier/Clavier Clavier F 0x0007 0x0009 0x0021 34
Clavier/Clavier Clavier G 0x0007 0x000A 0x0022 35
Clavier/Clavier Clavier H 0x0007 0x000B 0x0023 36
Clavier/Clavier Clavier I 0x0007 0x000C 0x0017 24
Clavier/Clavier Clavier J 0x0007 0x000D 0x0024 37
Clavier/Clavier Clavier K 0x0007 0x000E 0x0025 38
Clavier/Clavier Clavier L 0x0007 0x000F 0x0026 39
Clavier/Clavier Clavier M 0x0007 0x0010 0x0032 52
Clavier/Clavier Clavier N 0x0007 0x0011 0x0031 51
Clavier/Clavier Clavier O 0x0007 0x0012 0x0018 25
Clavier/Clavier Clavier P 0x0007 0x0013 0x0019 26
Clavier/Clavier Clavier Q 0x0007 0x0014 0x0010 17
Clavier/Clavier Clavier R 0x0007 0x0015 0x0013 20
Clavier/Clavier Clavier S 0x0007 0x0016 0x001F 32
Clavier/Clavier Clavier T 0x0007 0x0017 0x0014 21
Clavier/Clavier Clavier U 0x0007 0x0018 0x0016 23
Clavier/Clavier Clavier V 0x0007 0x0019 0x002F 49
Clavier/Clavier Clavier W 0x0007 0x001A 0x0011 18
Clavier/Clavier Clavier X 0x0007 0x001B 0x002D 47
Clavier/Clavier Clavier Y 0x0007 0x001C 0x0015 22
Clavier/Clavier Clavier Z 0x0007 0x001D 0x002C 46
Clavier/Clavier Clavier 1 et Bang 0x0007 0x001E 0x0002 2
Clavier/Clavier Clavier 2 et At 0x0007 0x001F 0x0003 3
Clavier/Clavier Clavier 3 et hachage 0x0007 0x0020 0x0004 4
Clavier/Clavier Clavier 4 et Dollar 0x0007 0x0021 0x0005 5
Clavier/Clavier Clavier 5 et pourcentage 0x0007 0x0022 0x0006 6
Clavier/Clavier Clavier 6 et caret 0x0007 0x0023 0x0007 7
Clavier/Clavier Clavier 7 et Ampersand 0x0007 0x0024 0x0008 8
Clavier/Clavier Clavier 8 et Étoile 0x0007 0x0025 0x0009 9
Clavier/Clavier Clavier 9 et crochet gauche 0x0007 0x0026 0x000A 10
Clavier/Clavier Clavier 0 et crochet droit 0x0007 0x0027 0x000B 11
Clavier/Clavier Entrée de retour du clavier 0x0007 0x0028 0x001C 43
Clavier/Clavier Échappement du clavier 0x0007 0x0029 0x0001 110
Clavier/Clavier Suppression du clavier 0x0007 0x002A 0x000E 15
Clavier/Clavier Onglet clavier 0x0007 0x002B 0x000F 16
Clavier/Clavier Espace du clavier 0x0007 0x002C 0x0039 61
Clavier/Clavier Tiret et trait de soulignement du clavier 0x0007 0x002D 0x000C 12
Clavier/Clavier Clavier égal et plus 0x0007 0x002E 0x000D 13
Clavier/Clavier Accolade gauche du clavier 0x0007 0x002F 0x001A 27
Clavier/Clavier Accolade droite du clavier 0x0007 0x0030 0x001B 28
Clavier/Clavier Canal du clavier et barre oblique 0x0007 0x0031 0x002B 29
Clavier/Clavier Clavier non-US 0x0007 0x0032 0x002B 42
Clavier/Clavier Point-virgule et deux-points du clavier 0x0007 0x0033 0x0027 40
Clavier/Clavier Apos gauche du clavier et double 0x0007 0x0034 0x0028 41
Clavier/Clavier Accent grave du clavier et Tilde 0x0007 0x0035 0x0029 1
Clavier/Clavier Virgule clavier 0x0007 0x0036 0x0033 53
Clavier/Clavier Période du clavier 0x0007 0x0037 0x0034 54
Clavier/Clavier QuestionMark du clavier 0x0007 0x0038 0x0035 55
Clavier/Clavier Verrouillage des majuscules du clavier 0x0007 0x0039 0x003A 30
Clavier/Clavier Clavier F1 0x0007 0x003A 0x003B 112
Clavier/Clavier Clavier F2 0x0007 0x003B 0x003C 113
Clavier/Clavier Clavier F3 0x0007 0x003C 0x003D 114
Clavier/Clavier Clavier F4 0x0007 0x003D 0x003E 115
Clavier/Clavier Clavier F5 0x0007 0x003E 0x003F 116
Clavier/Clavier Clavier F6 0x0007 0x003F 0x0040 117
Clavier/Clavier Clavier F7 0x0007 0x0040 0x0041 118
Clavier/Clavier Clavier F8 0x0007 0x0041 0x0042 119
Clavier/Clavier Clavier F9 0x0007 0x0042 0x0043 120
Clavier/Clavier Clavier F10 0x0007 0x0043 0x0044 121
Clavier/Clavier Clavier F11 0x0007 0x0044 0x0057 122
Clavier/Clavier Clavier F12 0x0007 0x0045 0x0058 123
Clavier/Clavier Clavier PrintScreen 0x0007 0x0046 0xE037
0x0054 *Note 1
124
Clavier/Clavier Verrouillage de défilement du clavier 0x0007 0x0047 0x0046 125
Clavier/Clavier Pause du clavier 0x0007 0x0048 0xE11D45
0xE046 *Note 2
0x0045 *Note 3
126
Clavier/Clavier Clavier Insertion 0x0007 0x0049 0xE052 75
Clavier/Clavier Clavier d’accueil 0x0007 0x004A 0xE047 80
Clavier/Clavier PageUp du clavier 0x0007 0x004B 0xE049 85 %
Clavier/Clavier Suppression du clavier vers l’avant 0x0007 0x004C 0xE053 76
Clavier/Clavier Fin du clavier 0x0007 0x004D 0xE04F 81
Clavier/Clavier PageDown du clavier 0x0007 0x004E 0xE051 86
Clavier/Clavier Clavier RightArrow 0x0007 0x004F 0xE04D 89
Clavier/Clavier Clavier GaucheArrow 0x0007 0x0050 0xE04B 79
Clavier/Clavier Clavier BasArrow 0x0007 0x0051 0xE050 84
Clavier/Clavier Clavier UpArrow 0x0007 0x0052 0xE048 83
Clavier/Clavier Verrouillage num du clavier et effacer 0x0007 0x0053 0x0045
0xE045 *Note 3
90
Clavier/Clavier Barre oblique du clavier 0x0007 0x0054 0xE035 95
Clavier/Clavier Étoile du pavé numérique 0x0007 0x0055 0x0037 100
Clavier/Clavier Tiret du clavier 0x0007 0x0056 0x004A 105
Clavier/Clavier Clavier Plus 0x0007 0x0057 0x004E 106
Clavier/Clavier Entrée du clavier 0x0007 0x0058 0xE01C 108
Clavier/Clavier Clavier 1 et Fin 0x0007 0x0059 0x004F 93
Clavier/Clavier Clavier 2 et flèche bas 0x0007 0x005A 0x0050 98
Clavier/Clavier Clavier 3 et PageDn 0x0007 0x005B 0x0051 103
Clavier/Clavier Clavier 4 et flèche gauche 0x0007 0x005C 0x004B 92
Clavier/Clavier Clavier 5 0x0007 0x005D 0x004C 97
Clavier/Clavier Clavier 6 et flèche droite 0x0007 0x005E 0x004D 102
Clavier/Clavier Clavier 7 et Accueil 0x0007 0x005F 0x0047 91
Clavier/Clavier Clavier 8 et flèche vers le haut 0x0007 0x0060 0x0048 96
Clavier/Clavier Clavier 9 et PageUp 0x0007 0x0061 0x0049 101
Clavier/Clavier Clavier 0 et Insertion 0x0007 0x0062 0x0052 99
Clavier/Clavier Période du clavier 0x0007 0x0063 0x0053 104
Clavier/Clavier Barre oblique du clavier autre que les États-Unis 0x0007 0x0064 0x0056 45
Clavier/Clavier Application clavier 0x0007 0x0065 0xE05D 129
Clavier/Clavier Alimentation du clavier 0x0007 0x0066 0xE05E
Clavier/Clavier Touches égales 0x0007 0x0067 0x0059
Clavier/Clavier Clavier F13 0x0007 0x0068 0x0064
Clavier/Clavier Clavier F14 0x0007 0x0069 0x0065
Clavier/Clavier Clavier F15 0x0007 0x006A 0x0066
Clavier/Clavier Clavier F16 0x0007 0x006B 0x0067
Clavier/Clavier Clavier F17 0x0007 0x006C 0x0068
Clavier/Clavier Clavier F18 0x0007 0x006D 0x0069
Clavier/Clavier Clavier F19 0x0007 0x006E 0x006A
Clavier/Clavier Clavier F20 0x0007 0x006F 0x006B
Clavier/Clavier Clavier F21 0x0007 0x0070 0x006C
Clavier/Clavier Clavier F22 0x0007 0x0071 0x006D
Clavier/Clavier Clavier F23 0x0007 0x0072 0x006E
Clavier/Clavier Clavier F24 0x0007 0x0073 0x0076
Clavier/Clavier Virgule du clavier 0x0007 0x0085 0x007E 107 *Note 4
Clavier/Clavier Clavier International1 0x0007 0x0087 0x0073 56 *Note 4, 5
Clavier/Clavier Clavier International2 0x0007 0x0088 0x0070 133 *Note 5
Clavier/Clavier Clavier International3 0x0007 0x0089 0x007D 14 *Note 5
Clavier/Clavier Clavier International4 0x0007 0x008A 0x0079 132 *Note 5
Clavier/Clavier Clavier International5 0x0007 0x008B 0x007B 131 *Note 5
Clavier/Clavier Clavier International6 0x0007 0x008C 0x005C
Clavier/Clavier Clavier LANG1 0x0007 0x0090 0x0072 *Note 6
Clavier/Clavier Clavier LANG2 0x0007 0x0091 0x0071 *Note 6
Clavier/Clavier Clavier LANG3 0x0007 0x0092 0x0078
Clavier/Clavier Clavier LANG4 0x0007 0x0093 0x0077
Clavier/Clavier Clavier LANG5 0x0007 0x0094 0x0076
Clavier/Clavier Clavier LeftControl 0x0007 0x00E0 0x001D 58
Clavier/Clavier Clavier LeftShift 0x0007 0x00E1 0x002A 44
Clavier/Clavier Clavier GaucheAlt 0x0007 0x00E2 0x0038 60
Clavier/Clavier Interface graphique graphique utilisateur gauche du clavier 0x0007 0x00E3 0xE05B 127
Clavier/Clavier Contrôle droit du clavier 0x0007 0x00E4 0xE01D 64
Clavier/Clavier Clavier RightShift 0x0007 0x00E5 0x0036 57
Clavier/Clavier Clavier RightAlt 0x0007 0x00E6 0xE038 62
Clavier/Clavier Interface graphique graphique de droite du clavier 0x0007 0x00E7 0xE05C 128
Consommateur Analyser la piste suivante 0x000C 0x00B5 0xE019
Consommateur Analyser la piste précédente 0x000C 0x00B6 0xE010
Consommateur Arrêter 0x000C 0x00B7 0xE024
Consommateur Lecture/Pause 0x000C 0x00CD 0xE022
Consommateur Désactiver le son 0x000C 0x00E2 0xE020
Consommateur Incrément de volume 0x000C 0x00E9 0xE030
Consommateur Décrémentation du volume 0x000C 0x00EA 0xE02E
Consommateur Configuration du contrôle du consommateur AL 0x000C 0x0183 0xE06D
Consommateur Lecteur Email AL 0x000C 0x018A 0xE06C
Consommateur Calculatrice AL 0x000C 0x0192 0xE021
Consommateur AL Local Machine Browser 0x000C 0x0194 0xE06B
Consommateur Recherche ac 0x000C 0x0221 0xE065
Consommateur Accueil AC 0x000C 0x0223 0xE032
Consommateur AC Back 0x000C 0x0224 0xE06A
Consommateur AC Forward 0x000C 0x0225 0xE069
Consommateur Arrêt du contrôle d’accès 0x000C 0x0226 0xE068
Consommateur Actualisation du secteur 0x000C 0x0227 0xE067
Consommateur Lien précédent ac 0x000C 0x022A 0xE066

Remarques :

  1. Le code d’analyse de la touche SysRq est affiché sur alt+frappe d’écran d’impression
  2. Le code d’analyse de la touche d’arrêt est émis lors de la séquence de touches Ctrl+Pause
  3. Comme indiqué dans les messages clavier hérités
  4. La touche est présente sur les claviers brésiliens
  5. La touche est présente sur les claviers japonais
  6. Le code d’analyse est emmited dans l’événement de mise en production de clé uniquement

Indicateur de touche étendue

L’indicateur de touche étendue indique si le message de frappe provient de l’une des touches supplémentaires du clavier amélioré 101/102. Les touches étendues sont les touches ALT et CTRL situées à droite du clavier ; les touches INSER, SUPPR, DÉBUT, FIN, PAGE HAUT, PAGE BAS et les flèches dans les clusters à gauche du pavé numérique ; la touche VERR NUM ; la touche ATTN (CTRL+PAUSE) ; la touche IMPR ÉCRAN ; et les touches de division (/) et ENTRÉE dans le pavé numérique. La touche MAJ de droite n’est pas considérée comme une touche étendue, elle possède un code d’analyse distinct.

S’il est spécifié, le code d’analyse se compose d’une séquence de deux octets, où le premier octet a une valeur de 0xE0.

Code de contexte

Le code de contexte indique si la touche ALT était enfoncée lorsque le message de frappe a été généré. Le code est 1 si la touche ALT était enfoncée et 0 si elle ne l’était pas.

Indicateur d’état de touche précédente

L’indicateur d’état de la touche précédente indique si la touche qui a généré le message de frappe était précédemment enfoncée ou non. Il vaut 1 si la touche était précédemment enfoncée et 0 si la touche était précédemment en position haute. Vous pouvez utiliser cet indicateur pour identifier les messages de frappe générés par la fonctionnalité de répétition automatique du clavier. Cet indicateur est défini sur 1 pour les messages de frappes WM_KEYDOWN et WM_SYSKEYDOWN générés par la fonctionnalité de répétition automatique. Elle est toujours définie sur 1 pour les messages WM_KEYUP et WM_SYSKEYUP.

Indicateur d’état de transition

L’indicateur d’état de transition indique si le fait d’appuyer sur une touche ou de relâcher une touche a généré le message de frappe. Cet indicateur est toujours défini sur 0 pour les messages WM_KEYDOWN et WM_SYSKEYDOWN ; il est toujours défini sur 1 pour les messages WM_KEYUP et WM_SYSKEYUP.

Messages de caractères

Les messages de frappe fournissent beaucoup d’informations sur les séquences de touches, mais ils ne fournissent pas de codes de caractères pour les séquences de touches de caractères. Pour récupérer des codes de caractères, une application doit inclure la fonction TranslateMessage dans sa boucle de message de thread. TranslateMessage transmet un message WM_KEYDOWN ou WM_SYSKEYDOWN à la disposition du clavier. La disposition examine le code de touche virtuelle du message et, s’il correspond à une touche de caractère, fournit le code de caractère équivalent (en tenant compte de l’état des touches MAJ et VERR MAJ). Il génère ensuite un message de caractères qui inclut le code du caractère et place le message en haut de la file d’attente des messages. L’itération suivante de la boucle de message supprime le message caractère de la file d’attente et distribue le message à la procédure de fenêtre appropriée.

Cette section couvre les sujets suivants :

Messages de caractères non système

Une procédure de fenêtre peut recevoir les messages caractères suivants : WM_CHAR, WM_DEADCHAR, WM_SYSCHAR, WM_SYSDEADCHAR et WM_UNICHAR. La fonction TranslateMessage génère un message WM_CHAR ou WM_DEADCHAR lorsqu’elle traite un message WM_KEYDOWN. De même, elle génère un message WM_SYSCHAR ou WM_SYSDEADCHAR lorsqu’elle traite un message WM_SYSKEYDOWN.

Une application qui traite l’entrée du clavier ignore généralement tous les messages à l’exception des WM_CHAR et WM_UNICHAR, en passant tous les autres messages à la fonction DefWindowProc. Notez que WM_CHAR utilise UTF-16 (format de transformation Unicode 16 bits) ou un jeu de caractères ANSI, tandis que WM_UNICHAR utilise toujours UTF-32 (format de transformation Unicode 32 bits). Le système utilise les messages WM_SYSCHAR et WM_SYSDEADCHAR pour implémenter les mnémoniques de menu.

Le paramètre wParam de tous les messages de caractères contient le code de caractère de la touche de caractère qui a été enfoncée. La valeur du code de caractère dépend de la classe window de la fenêtre qui reçoit le message. Si la version Unicode de la fonction RegisterClass a été utilisée pour inscrire la classe window, le système fournit des caractères Unicode à toutes les fenêtres de cette classe. Sinon, le système fournit des codes de caractères ANSI. Pour plus d’informations, consultez Inscription de classes Window et Utiliser des pages de code UTF-8 dans les applications Windows.

Le contenu du paramètre lParam d’un message de caractère est identique au contenu du paramètre lParam du message d’activation de touche qui a été traduit pour produire le message de caractère. Pour plus d’informations, consultez Indicateurs de message de frappe.

Messages de caractères morts

Certains claviers non anglais contiennent des touches de caractères qui ne sont pas censées produire des caractères par elles-mêmes. Au lieu de cela, ils sont utilisés pour ajouter un diacritique au caractère produit par la frappe suivante. Ces touches sont appelées touches mortes. La touche circonflexe d’un clavier allemand est un exemple de touche morte. Pour entrer le caractère composé d’un « o » et d’un accent circonflexe, un utilisateur allemand taperait la touche circonflexe suivie de la touche « o ». La fenêtre avec le focus clavier reçoit la séquence de messages suivante :

  1. WM_KEYDOWN
  2. WM_DEADCHAR
  3. WM_KEYUP
  4. WM_KEYDOWN
  5. WM_CHAR
  6. WM_KEYUP

TranslateMessage génère le message WM_DEADCHAR lorsqu’il traite le message WM_KEYDOWN à partir d’une touche morte. Bien que le paramètre wParam du message WM_DEADCHAR contienne le code de caractère du diacritique de la touche morte, une application ignore généralement le message. Au lieu de cela, il traite le message WM_CHAR généré par la frappe suivante. Le paramètre wParam du message WM_CHAR contient le code de caractère de la lettre avec le diacritique. Si la frappe suivante génère un caractère qui ne peut pas être combiné avec un diacritique, le système génère deux messages WM_CHAR. Le paramètre wParam du premier contient le code de caractère du diacritique ; le paramètre wParam du second contient le code de caractère de la touche de caractère suivante.

La fonction TranslateMessage génère le message WM_SYSDEADCHAR lorsqu’elle traite le message WM_SYSKEYDOWN à partir d’une touche morte système (une touche morte enfoncée en combinaison avec la touche ALT). Une application ignore généralement le message WM_SYSDEADCHAR.

État de la touche

Lors du traitement d’un message clavier, une application peut avoir besoin de déterminer l’état d’une autre touche que celle qui a généré le message actuel. Par exemple, une application de traitement de texte qui permet à l’utilisateur d’appuyer sur MAJ+FIN pour sélectionner un bloc de texte doit vérifier l’état de la touche MAJ chaque fois qu’il reçoit un message de frappe de la touche FIN. L’application peut utiliser la fonction GetKeyState pour déterminer l’état d’une touche virtuelle au moment de la génération du message actuel; elle peut utiliser la fonction GetAsyncKeyState pour récupérer l’état actuel d’une touche virtuelle.

La disposition du clavier conserve une liste de noms. Le nom d’une touche qui produit un caractère unique est le même que le caractère produit par la touche. Le nom d’une touche non caractéristique, telle que TAB et ENTRÉE, est stocké sous la forme d’une chaîne de caractères. Une application peut récupérer le nom d’une touche à partir du pilote de périphérique en appelant la fonction GetKeyNameText.

Traductions de touches et de frappes

Le système comprend plusieurs fonctions spéciales qui traduisent les codes d’analyse, les codes de caractères et les codes de touche virtuelle fournis par différents messages de frappe. Ces fonctions incluent MapVirtualKey, ToAscii, ToUnicode et VkKeyScan.

En outre, Microsoft Rich Edit 3.0 prend en charge l’IME HexToUnicode, qui permet à un utilisateur de convertir les caractères hexadécimaux et les caractères Unicode à l’aide de touches de raccourci. Cela signifie que lorsque Microsoft Rich Edit 3.0 est incorporé dans une application, celle-ci hérite des fonctionnalités de l’IME HexToUnicode.

Prise en charge des raccourcis clavier

Un raccourci clavier est une combinaison de touches qui génère un message WM_HOTKEY, un message que le système place en haut de la file d’attente de messages d’un thread, contournant tous les messages existants dans la file d’attente. Les applications utilisent des raccourcis clavier pour obtenir une entrée de clavier à priorité élevée de la part de l’utilisateur. Par exemple, en définissant un raccourci clavier composé de la combinaison de touches CTRL+C, une application peut permettre à l’utilisateur d’annuler une opération de longue durée.

Pour définir un raccourci clavier, une application appelle la fonction RegisterHotKey, en spécifiant la combinaison de touches qui génère le message WM_HOTKEY, le handle de la fenêtre pour recevoir le message et l’identificateur du raccourci clavier. Lorsque l’utilisateur appuie sur le raccourci clavier, un message WM_HOTKEY est placé dans la file d’attente de messages du thread qui a créé la fenêtre. Le paramètre wParam du message contient l’identificateur du raccourci clavier. L’application peut définir plusieurs raccourcis clavier pour un thread, mais chaque raccourci clavier du thread doit avoir un identificateur unique. Avant de se terminer, l’application doit utiliser la fonction UnregisterHotKey pour détruire le raccourci clavier.

Les applications peuvent utiliser un contrôle de raccourci clavier pour faciliter le choix d’un raccourci clavier par l’utilisateur. Les contrôles de raccourci clavier sont généralement utilisés pour définir un raccourci clavier qui active une fenêtre ; ils n’utilisent pas les fonctions RegisterHotKey et UnregisterHotKey. Au lieu de cela, une application qui utilise un contrôle de raccourci clavier envoie généralement le message WM_SETHOTKEY pour définir le raccourci clavier. Chaque fois que l’utilisateur appuie sur le raccourci clavier, le système envoie un message WM_SYSCOMMAND spécifiant SC_HOTKEY. Pour plus d’informations sur les contrôles de raccourci clavier, consultez « Utilisation des contrôles de raccourci clavier » dans Contrôles de raccourci clavier.

Touches de clavier pour la navigation et d’autres fonctions

Windows prend en charge les claviers dotés de touches spéciales pour les fonctions de navigateur, les fonctions multimédias, le lancement d’applications et la gestion de l’alimentation. Le WM_APPCOMMAND prend en charge les touches de clavier supplémentaires. En outre, la fonction ShellProc est modifiée pour prendre en charge les touches de clavier supplémentaires.

Il est peu probable qu’une fenêtre enfant d’une application de composant puisse implémenter directement des commandes pour ces touches de clavier supplémentaires. Par conséquent, lorsque l’une de ces touches est enfoncée, DefWindowProc envoie un message WM_APPCOMMAND à une fenêtre. DefWindowProc envoie également le message WM_APPCOMMAND dans sa fenêtre parent. Cela est similaire à la façon dont les menus contextuels sont appelés avec le bouton droit de la souris, c’est-à-dire que DefWindowProc envoie un message WM_CONTEXTMENU lors d’un clic droit, et l’envoie à son parent. En outre, si DefWindowProc reçoit un message WM_APPCOMMAND pour une fenêtre de niveau supérieur, il appelle un crochet d’interpréteur de commandes avec du code HSHELL_APPCOMMAND.

Windows prend également en charge l’Explorateur Microsoft IntelliMouse, qui est une souris avec cinq boutons. Les deux boutons supplémentaires permettent de naviguer vers l’avant et vers l’arrière. Pour plus d’informations, consultez XBUTTONs.

Simulation d’entrée

Pour simuler une série ininterrompue d’événements d’entrée utilisateur, utilisez la fonction SendInput. La fonction accepte trois paramètres. Le premier paramètre, cInputs, indique le nombre d’événements d’entrée qui seront simulés. Le deuxième paramètre, rgInputs, est un tableau de structures INPUT, chacune décrivant un type d’événement d’entrée et des informations supplémentaires sur cet événement. Le dernier paramètre, cbSize, accepte la taille de la structure INPUT, en octets.

La fonction SendInput fonctionne en injectant une série d’événements d’entrée simulés dans le flux d’entrée d’un appareil. L’effet est similaire à l’appel répété de la fonction keybd_event ou mouse_event, sauf que le système garantit qu’aucun autre événement d’entrée ne s’entremêle avec les événements simulés. Une fois l’appel terminé, la valeur de retour indique le nombre d’événements d’entrée correctement lus. Si cette valeur est égale à zéro, l’entrée a été bloquée.

La fonction SendInput ne réinitialise pas l’état actuel du clavier. Par conséquent, si l’utilisateur a des touches enfoncées lorsque vous appelez cette fonction, elles peuvent interférer avec les événements générés par cette fonction. Si vous êtes préoccupé par les interférences possibles, vérifiez l’état du clavier avec la fonction GetAsyncKeyState et corrigez si nécessaire.

Langues, paramètres régionaux et dispositions du clavier

Une langue est une langue naturelle, comme l’anglais, le français et le japonais. Une sous-langue est une variante d’une langue naturelle parlée dans une région géographique spécifique, comme les sous-langues anglaises parlées au Royaume-Uni et les États-Unis. Les applications utilisent des valeurs, appelées identificateurs de langue, pour identifier de manière unique les langues et les sous-langues.

Les applications utilisent généralement des paramètres régionaux pour définir la langue dans laquelle l’entrée et la sortie sont traitées. La définition des paramètres régionaux pour le clavier, par exemple, affecte les valeurs de caractères générées par le clavier. La définition des paramètres régionaux pour l’affichage ou l’imprimante affecte les glyphes affichés ou imprimés. Les applications définissent les paramètres régionaux d’un clavier en chargeant et en utilisant des dispositions de clavier. Ils définissent les paramètres régionaux d’un affichage ou d’une imprimante en sélectionnant une police qui prend en charge les paramètres régionaux spécifiés.

Une disposition de clavier spécifie non seulement la position physique des touches sur le clavier, mais détermine également les valeurs de caractères générées en appuyant sur ces touches. Chaque disposition identifie la langue d’entrée actuelle et détermine quelles valeurs de caractère sont générées par quelles touches et combinaisons de touches.

Chaque disposition de clavier a un handle correspondant qui identifie la disposition et la langue. Le mot faible du handle est un identificateur de langue. Le mot fort est un handle d’appareil, spécifiant la disposition physique, ou est égal à zéro, indiquant une disposition physique par défaut. L’utilisateur peut associer n’importe quelle langue d’entrée à une disposition physique. Par exemple, un utilisateur anglophone qui travaille très occasionnellement en français peut définir la langue d’entrée du clavier sur le français sans modifier la disposition physique du clavier. Cela signifie que l’utilisateur peut entrer du texte en français en utilisant la disposition anglaise familière.

Les applications ne sont généralement pas censées manipuler directement les langages d’entrée. Au lieu de cela, l’utilisateur configure des combinaisons de langue et de disposition, puis passe de l’une à l’autre. Lorsque l’utilisateur clique sur du texte marqué d’une langue différente, l’application appelle la fonction ActivateKeyboardLayout pour activer la disposition par défaut de l’utilisateur pour cette langue. Si l’utilisateur modifie du texte dans une langue qui ne figure pas dans la liste active, l’application peut appeler la fonction LoadKeyboardLayout avec la langue pour obtenir une disposition basée sur cette langue.

La fonction ActivateKeyboardLayout définit la langue d’entrée de la tâche actuelle. Le paramètre hkl peut être le handle de la disposition du clavier ou un identificateur de langue étendu zéro. Les handles de disposition du clavier peuvent être obtenues à partir de la fonction LoadKeyboardLayout ou GetKeyboardLayoutList. Les valeurs HKL_NEXT et HKL_PREV peuvent également être utilisées pour sélectionner le clavier suivant ou précédent.

La fonction GetKeyboardLayoutName récupère le nom de la disposition de clavier active pour le thread appelant. Si une application crée la disposition active à l’aide de la fonction LoadKeyboardLayout, GetKeyboardLayoutName récupère la même chaîne que celle utilisée pour créer la disposition. Sinon, la chaîne est l’identificateur de langue principal correspondant aux paramètres régionaux de la disposition active. Cela signifie que la fonction ne peut pas nécessairement faire la différence entre les différentes dispositions ayant la même langue primaire. Elle ne peut donc pas retourner d’informations spécifiques sur la langue d’entrée. Toutefois, la fonction GetKeyboardLayout peut être utilisée pour déterminer la langue d’entrée.

La fonction LoadKeyboardLayout charge une disposition de clavier et la met à disposition de l’utilisateur. Les applications peuvent rendre la disposition immédiatement active pour le thread actif à l’aide de la valeur KLF_ACTIVATE. Une application peut utiliser la valeur KLF_REORDER pour réorganiser les dispositions sans spécifier la valeur KLF_ACTIVATE. Les applications doivent toujours utiliser la valeur KLF_SUBSTITUTE_OK lors du chargement des dispositions du clavier pour s’assurer que la préférence de l’utilisateur, le cas échéant, est sélectionnée.

Pour la prise en charge multilingue, la fonction LoadKeyboardLayout fournit les indicateurs KLF_REPLACELANG et KLF_NOTELLSHELL. L’indicateur KLF_REPLACELANG indique à la fonction de remplacer une disposition de clavier existante sans modifier la langue. La tentative de remplacement d’une disposition existante à l’aide du même identificateur de langue, mais sans spécifier KLF_REPLACELANG est une erreur. L’indicateur KLF_NOTELLSHELL empêche la fonction d’avertir l’interpréteur de commandes lorsqu’une disposition de clavier est ajoutée ou remplacée. Cela est utile pour les applications qui ajoutent plusieurs dispositions dans une série consécutive d’appels. Cet indicateur doit être utilisé dans tout les cas, sauf lors du dernier appel.

La fonction UnloadKeyboardLayout est limitée en ce qu’elle ne peut pas décharger la langue d’entrée par défaut du système. Cela garantit que l’utilisateur dispose toujours d’une disposition pour entrer du texte en utilisant le même jeu de caractères que celui utilisé par l’interpréteur de commandes et le système de fichiers.