Keys Énumération

Définition

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]
[System.Runtime.InteropServices.ComVisible(true)]
public enum Keys
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))]
[System.Flags]
public enum Keys
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))>]
[<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Keys = 
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))>]
[<System.Flags>]
type Keys = 
Public Enum Keys
Héritage
Attributs

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

S’applique à

Voir aussi