Keys Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Spécifie des codes et des modificateurs de touche.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class Keys

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))]
[System.Flags]
public enum Keys

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))>]
[<System.Flags>]
type Keys = 

Public Enum Keys

Héritage

Object

ValueType

Enum

Keys

Attributs

TypeConverterAttribute FlagsAttribute

Champs

A	65	Touche A.
Add	107	La touche Ajouter.
Alt	262144	La touche de modification Alt.
Apps	93	La touche Application (clavier Microsoft Natural Keyboard).
Attn	246	Touche ATTN.
B	66	Touche B.
Back	8	Touche Retour arrière.
BrowserBack	166	Touche de page précédente du navigateur.
BrowserFavorites	171	Touche des favoris du navigateur.
BrowserForward	167	Touche de page suivante du navigateur.
BrowserHome	172	Touche de début du navigateur.
BrowserRefresh	168	Touche d’actualisation du navigateur.
BrowserSearch	170	Touche de recherche du navigateur.
BrowserStop	169	Touche d’arrêt du navigateur.
C	67	Touche C.
Cancel	3	La touche ANNULER.
Capital	20	La touche CAPS LOCK.
CapsLock	20	La touche CAPS LOCK.
Clear	12	Touche Effacer.
Control	131072	La touche de modification Ctrl.
ControlKey	17	Touche CTRL.
Crsel	247	Touche CRSEL.
D	68	Touche D.
D0	48	Touche 0.
D1	49	Touche 1.
D2	50	Touche 2.
D3	51	Touche 3.
D4	52	Touche 4.
D5	53	Touche 5.
D6	54	Touche 6.
D7	55	Touche 7.
D8	56	Touche 8.
D9	57	Touche 9.
Decimal	110	La touche de décimale.
Delete	46	Touche DEL.
Divide	111	La touche de division.
Down	40	Touche Bas.
E	69	Touche E.
End	35	Touche Fin.
Enter	13	Touche Entrée.
EraseEof	249	Touche ERASE EOF.
Escape	27	Touche Échap.
Execute	43	Touche d’exécution.
Exsel	248	Touche EXSEL.
F	70	Touche F.
F1	112	Touche F1.
F10	121	Touche F10.
F11	122	Touche F11.
F12	123	Touche F12.
F13	124	Touche F13.
F14	125	Touche F14.
F15	126	Touche F15.
F16	127	Touche F16.
F17	128	Touche F17.
F18	129	Touche F18.
F19	130	Touche F19.
F2	113	Touche F2.
F20	131	Touche F20.
F21	132	Touche F21.
F22	133	Touche F22.
F23	134	Touche F23.
F24	135	Touche F24.
F3	114	Touche F3.
F4	115	Touche F4.
F5	116	Touche F5.
F6	117	Touche F6.
F7	118	Touche F7.
F8	119	Touche F8.
F9	120	Touche F9.
FinalMode	24	La touche mode final IME.
G	71	Touche G.
H	72	Touche H.
HanguelMode	21	La touche mode Hangul IME (conservée pour la compatibilité ; utilisez HangulMode).
HangulMode	21	Touche mode Hangul IME.
HanjaMode	25	Touche mode Hanja IME.
Help	47	Touche Aide.
Home	36	Touche Début.
I	73	Touche I.
IMEAccept	30	La touche Accepter IME remplace IMEAceept.
IMEAceept	30	La touche Accepter IME. Obsolète, utilisez plutôt IMEAccept.
IMEConvert	28	La touche de conversion IME.
IMEModeChange	31	La touche de modification de mode IME.
IMENonconvert	29	La touche Nonconvert IME.
Insert	45	Touche INS.
J	74	Touche J.
JunjaMode	23	Touche mode Junja IME.
K	75	Touche K.
KanaMode	21	Touche mode Kana IME.
KanjiMode	25	Touche mode Kanji IME.
KeyCode	65535	Le masque de bits pour extraire un code de touche à partir d'une valeur de touche.
L	76	Touche L.
LaunchApplication1	182	Touche Démarrer l'application 1.
LaunchApplication2	183	Touche Démarrer l'application 2.
LaunchMail	180	Touche de démarrage de la messagerie.
LButton	1	Bouton gauche de la souris.
LControlKey	162	Touche CTRL de gauche.
Left	37	Touche Gauche.
LineFeed	10	La touche SAUT DE LIGNE.
LMenu	164	Touche ALT de gauche.
LShiftKey	160	La touche MAJ de gauche.
LWin	91	Touche du logo Windows de gauche (clavier Microsoft Natural Keyboard).
M	77	Touche M.
MButton	4	Le bouton central de la souris (souris à trois boutons).
MediaNextTrack	176	Touche de piste suivante du média.
MediaPlayPause	179	Touche de lecture/pause du média.
MediaPreviousTrack	177	Touche de piste précédente du média.
MediaStop	178	Touche d’arrêt du média.
Menu	18	Touche ALT.
Modifiers	-65536	Le masque de bits pour extraire les modificateurs à partir d'une valeur de touche.
Multiply	106	La touche de multiplication.
N	78	Touche N.
Next	34	Touche Page suivante.
NoName	252	Constante réservée à un usage ultérieur.
None	0	Aucune touche enfoncée.
NumLock	144	La touche NUM LOCK.
NumPad0	96	Touche 0 du pavé numérique.
NumPad1	97	Touche 1 du pavé numérique.
NumPad2	98	Touche 2 du pavé numérique.
NumPad3	99	Touche 3 du pavé numérique.
NumPad4	100	Touche 4 du pavé numérique.
NumPad5	101	Touche 5 du pavé numérique.
NumPad6	102	Touche 6 du pavé numérique.
NumPad7	103	Touche 7 du pavé numérique.
NumPad8	104	Touche 8 du pavé numérique.
NumPad9	105	Touche 9 du pavé numérique.
O	79	Touche O.
Oem1	186	Touche OEM 1.
Oem102	226	Touche OEM 102.
Oem2	191	Touche OEM 2.
Oem3	192	Touche OEM 3.
Oem4	219	Touche OEM 4.
Oem5	220	Touche OEM 5.
Oem6	221	Touche OEM 6.
Oem7	222	Touche OEM 7.
Oem8	223	Touche OEM 8.
OemBackslash	226	Touche OEM de guillemets ou de barre oblique inverse sur le clavier RT de 102 touches.
OemClear	254	Touche Effacer.
OemCloseBrackets	221	Touche OEM de crochet fermant sur un clavier standard américain.
Oemcomma	188	Touche OEM de virgule sur un clavier destiné à un pays/région déterminé.
OemMinus	189	Touche OEM de soustraction sur un clavier destiné à un pays/région déterminé.
OemOpenBrackets	219	Touche OEM de crochet ouvrant sur un clavier standard américain.
OemPeriod	190	Touche OEM de point sur un clavier destiné à un pays/région déterminé.
OemPipe	220	Touche OEM de barre verticale sur un clavier standard américain.
Oemplus	187	Touche OEM d’addition sur un clavier destiné à un pays/région déterminé.
OemQuestion	191	Touche OEM du point d'interrogation sur un clavier standard américain.
OemQuotes	222	Touche OEM des guillemets simples et doubles sur un clavier standard américain.
OemSemicolon	186	Touche OEM du point-virgule sur un clavier standard américain.
Oemtilde	192	Touche OEM du tilde sur un clavier standard américain.
P	80	Touche P.
Pa1	253	Touche PA1.
Packet	231	Permet de passer des caractères Unicode comme s'il s'agissait de séquences de touches. La valeur de la touche Paquet est le mot inférieur d'une valeur de clé virtuelle 32 bits utilisée pour les méthodes d'entrée autres qu'au clavier.
PageDown	34	Touche Page suivante.
PageUp	33	Touche Page précédente.
Pause	19	Touche Pause.
Play	250	Touche de lecture.
Print	42	Touche d’impression.
PrintScreen	44	Touche Impr. écran.
Prior	33	Touche Page précédente.
ProcessKey	229	La touche PROCESS KEY.
Q	81	Touche Q.
R	82	Touche R.
RButton	2	Bouton droit de la souris.
RControlKey	163	Touche CTRL de droite.
Return	13	La touche RETOUR.
Right	39	Touche Droite.
RMenu	165	Touche ALT de droite.
RShiftKey	161	La touche MAJ de droite.
RWin	92	Touche du logo Windows de droite (clavier Microsoft Natural Keyboard).
S	83	Touche S.
Scroll	145	La touche ARRÊT DÉFILEMENT.
Select	41	Touche de sélection.
SelectMedia	181	Touche de sélection du média.
Separator	108	La touche du séparateur.
Shift	65536	La touche de modification MAJ.
ShiftKey	16	Touche MAJ (MAJUSCULE).
Sleep	95	La touche de mise en veille de l'ordinateur.
Snapshot	44	Touche Impr. écran.
Space	32	Touche Espace.
Subtract	109	La touche de soustraction.
T	84	Touche T.
Tab	9	Touche Tabulation.
U	85	Touche U.
Up	38	Touche Haut.
V	86	Touche V.
VolumeDown	174	Touche de réduction du volume.
VolumeMute	173	Touche de désactivation du volume.
VolumeUp	175	Touche d’augmentation du volume.
W	87	Touche W.
X	88	Touche X.
XButton1	5	Le premier bouton x de la souris (souris à cinq boutons).
XButton2	6	Le second bouton x de la souris (souris à cinq boutons).
Y	89	Touche Y.
Z	90	Touche Z.
Zoom	251	Touche ZOOM.

Exemples

L’exemple de code suivant utilise l’événement KeyDown pour déterminer le type de caractère entré dans le contrôle.

   // Boolean flag used to determine when a character other than a number is entered.
private:
   bool nonNumberEntered;

   // Handle the KeyDown event to determine the type of character entered into the control.
   void textBox1_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
   {
      // Initialize the flag to false.
      nonNumberEntered = false;

      // Determine whether the keystroke is a number from the top of the keyboard.
      if ( e->KeyCode < Keys::D0 || e->KeyCode > Keys::D9 )
      {
         // Determine whether the keystroke is a number from the keypad.
         if ( e->KeyCode < Keys::NumPad0 || e->KeyCode > Keys::NumPad9 )
         {
            // Determine whether the keystroke is a backspace.
            if ( e->KeyCode != Keys::Back )
            {
               // A non-numerical keystroke was pressed.
               // Set the flag to true and evaluate in KeyPress event.
               nonNumberEntered = true;
            }
         }
      }
      //If shift key was pressed, it's not a number.
      if (Control::ModifierKeys == Keys::Shift) {
         nonNumberEntered = true;
      }
   }

   // This event occurs after the KeyDown event and can be used to prevent
   // characters from entering the control.
   void textBox1_KeyPress( Object^ /*sender*/, System::Windows::Forms::KeyPressEventArgs^ e )
   {
      // Check for the flag being set in the KeyDown event.
      if ( nonNumberEntered == true )
      {         // Stop the character from being entered into the control since it is non-numerical.
         e->Handled = true;
      }
   }

// Boolean flag used to determine when a character other than a number is entered.
private bool nonNumberEntered = false;

// Handle the KeyDown event to determine the type of character entered into the control.
private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Initialize the flag to false.
    nonNumberEntered = false;

    // Determine whether the keystroke is a number from the top of the keyboard.
    if (e.KeyCode < Keys.D0 || e.KeyCode > Keys.D9)
    {
        // Determine whether the keystroke is a number from the keypad.
        if (e.KeyCode < Keys.NumPad0 || e.KeyCode > Keys.NumPad9)
        {
            // Determine whether the keystroke is a backspace.
            if(e.KeyCode != Keys.Back)
            {
                // A non-numerical keystroke was pressed.
                // Set the flag to true and evaluate in KeyPress event.
                nonNumberEntered = true;
            }
        }
    }
    //If shift key was pressed, it's not a number.
    if (Control.ModifierKeys == Keys.Shift) {
        nonNumberEntered = true;
    }
}

// This event occurs after the KeyDown event and can be used to prevent
// characters from entering the control.
private void textBox1_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e)
{
    // Check for the flag being set in the KeyDown event.
    if (nonNumberEntered == true)
    {
        // Stop the character from being entered into the control since it is non-numerical.
        e.Handled = true;
    }
}

 ' Boolean flag used to determine when a character other than a number is entered.
 Private nonNumberEntered As Boolean = False


 ' Handle the KeyDown event to determine the type of character entered into the control.
 Private Sub textBox1_KeyDown(sender As Object, e As System.Windows.Forms.KeyEventArgs) _
      Handles textBox1.KeyDown
     ' Initialize the flag to false.
     nonNumberEntered = False
   
     ' Determine whether the keystroke is a number from the top of the keyboard.
     If e.KeyCode < Keys.D0 OrElse e.KeyCode > Keys.D9 Then
         ' Determine whether the keystroke is a number from the keypad.
         If e.KeyCode < Keys.NumPad0 OrElse e.KeyCode > Keys.NumPad9 Then
             ' Determine whether the keystroke is a backspace.
             If e.KeyCode <> Keys.Back Then
                 ' A non-numerical keystroke was pressed. 
                 ' Set the flag to true and evaluate in KeyPress event.
                 nonNumberEntered = True
             End If
         End If
     End If
     'If shift key was pressed, it's not a number.
     If Control.ModifierKeys = Keys.Shift Then
         nonNumberEntered = true
     End If
 End Sub


 ' This event occurs after the KeyDown event and can be used 
 ' to prevent characters from entering the control.
 Private Sub textBox1_KeyPress(sender As Object, e As System.Windows.Forms.KeyPressEventArgs) _
     Handles textBox1.KeyPress
     ' Check for the flag being set in the KeyDown event.
     If nonNumberEntered = True Then
         ' Stop the character from being entered into the control since it is non-numerical.
         e.Handled = True
     End If
 End Sub

Remarques

La Keys classe contient des constantes pour le traitement de l’entrée du clavier. Les membres de l’énumération Keys se composent d’un code de clé et d’un ensemble de modificateurs combinés en une seule valeur entière. Dans l’interface de programmation d’application (API) Win32, une valeur de clé a deux moitiés, les bits d’ordre élevé contenant le code de clé (qui est le même qu’un code de clé virtuelle Windows) et les bits d’ordre bas représentant les modificateurs de clé tels que les touches MAJ, CONTROL et ALT.

Avertissement

N’utilisez pas les valeurs de cette énumération pour les opérations combinées au niveau du bit. Les valeurs de l’énumération ne s’excluent pas mutuellement.

Notes

Cette énumération ne permet pas de tester si les clés CAPS LOCK ou NUM LOCK sont actuellement activées. Vous pouvez utiliser l’une des techniques suivantes pour déterminer si ces clés sont activées :

• Appelez la méthode IsKeyLocked de la classe Control .

• Pour un contrôle plus fin, utilisez les fonctions GetKeyStated’API Windows , GetAsyncKeyStateou GetKeyboardState définies dans user32.dll. Pour plus d’informations sur l’appel de fonctions natives, consultez Consommation de fonctions DLL non managées.

Le tableau suivant montre les valeurs de code de clé représentées par deux valeurs énumérées, représentant à la fois les touches OEM (General Original Equipment Manufacturer) et les associations de clavier plus spécifiques aux États-Unis.

Valeur hexadécimale	Clavier américain	OEM général
BA	OemSemicolon	Oem1
BF	OemQuestion	Oem2
C0	Oemtilde	Oem3
DB	OemOpenBrackets	Oem4
DC	OemPipe	Oem5
DD	OemCloseBrackets	Oem6
DE	OemQuotes	Oem7
E2	Barre oblique OemBackslash	Oem102

Attention

Pour .NET Framework 2.0, un membre IMEAccept a été ajouté qui remplace l’entrée précédente, IMEAceept, qui a été mal orthographié. L’ancienne version a été conservée à des fins de compatibilité descendante, mais elle peut être supprimée dans les versions ultérieures du .NET Framework

Voir aussi

• KeysConverter
• SendKeys
• ConsoleKey
• Shortcut
• ModifierKeys
• IsKeyLocked(Keys)
• KeyEventArgs