Keys Enumeração

Definição

Especifica os modificadores e códigos de tecla.Specifies key codes and modifiers.

Esta enumeração tem um atributo FlagsAttribute que permite uma combinação bit a bit dos seus valores membros.

public enum class Keys
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))]
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
public enum Keys
type Keys = 
Public Enum Keys
Herança
Atributos

Campos

A 65

A tecla A.The A key.

Add 107

A tecla Adicionar.The add key.

Alt 262144

A tecla modificadora ALT.The ALT modifier key.

Apps 93

A tecla Aplicativo (Microsoft Natural Keyboard).The application key (Microsoft Natural Keyboard).

Attn 246

A tecla ATTN.The ATTN key.

B 66

A tecla B.The B key.

Back 8

A tecla BACKSPACE.The BACKSPACE key.

BrowserBack 166

A tecla Voltar do navegador (Windows 2000 ou posterior).The browser back key (Windows 2000 or later).

BrowserFavorites 171

A tecla Favoritos do navegador (Windows 2000 ou posterior).The browser favorites key (Windows 2000 or later).

BrowserForward 167

A tecla Avançar do navegador (Windows 2000 ou posterior).The browser forward key (Windows 2000 or later).

BrowserHome 172

A tecla Início do navegador (Windows 2000 ou posterior).The browser home key (Windows 2000 or later).

BrowserRefresh 168

A tecla Atualizar do navegador (Windows 2000 ou posterior).The browser refresh key (Windows 2000 or later).

BrowserSearch 170

A tecla Pesquisar do navegador (Windows 2000 ou posterior).The browser search key (Windows 2000 or later).

BrowserStop 169

A tecla Parar do navegador (Windows 2000 ou posterior).The browser stop key (Windows 2000 or later).

C 67

A tecla C.The C key.

Cancel 3

A tecla CANCEL.The CANCEL key.

Capital 20

A tecla CAPS LOCK.The CAPS LOCK key.

CapsLock 20

A tecla CAPS LOCK.The CAPS LOCK key.

Clear 12

A tecla CLEAR.The CLEAR key.

Control 131072

A tecla modificadora CTRL.The CTRL modifier key.

ControlKey 17

A tecla CTRL.The CTRL key.

Crsel 247

A tecla CRSEL.The CRSEL key.

D 68

A tecla D.The D key.

D0 48

A tecla 0.The 0 key.

D1 49

A tecla 1.The 1 key.

D2 50

A tecla 2.The 2 key.

D3 51

A tecla 3.The 3 key.

D4 52

A tecla 4.The 4 key.

D5 53

A tecla 5.The 5 key.

D6 54

A tecla 6.The 6 key.

D7 55

A tecla 7.The 7 key.

D8 56

A tecla 8.The 8 key.

D9 57

A tecla 9.The 9 key.

Decimal 110

A tecla Decimal.The decimal key.

Delete 46

A tecla DEL.The DEL key.

Divide 111

A tecla Dividir.The divide key.

Down 40

A tecla SETA PARA BAIXO.The DOWN ARROW key.

E 69

A tecla E.The E key.

End 35

A tecla END.The END key.

Enter 13

A tecla ENTER.The ENTER key.

EraseEof 249

A tecla ERASE EOF.The ERASE EOF key.

Escape 27

A tecla ESC.The ESC key.

Execute 43

A tecla EXECUTE.The EXECUTE key.

Exsel 248

A tecla EXSEL.The EXSEL key.

F 70

A tecla F.The F key.

F1 112

A tecla F1.The F1 key.

F10 121

A tecla F10.The F10 key.

F11 122

A tecla F11.The F11 key.

F12 123

A tecla F12.The F12 key.

F13 124

A tecla F13.The F13 key.

F14 125

A tecla F14.The F14 key.

F15 126

A tecla F15.The F15 key.

F16 127

A tecla F16.The F16 key.

F17 128

A tecla F17.The F17 key.

F18 129

A tecla F18.The F18 key.

F19 130

A tecla F19.The F19 key.

F2 113

A tecla F2.The F2 key.

F20 131

A tecla F20.The F20 key.

F21 132

A tecla F21.The F21 key.

F22 133

A tecla F22.The F22 key.

F23 134

A tecla F23.The F23 key.

F24 135

A tecla F24.The F24 key.

F3 114

A tecla F3.The F3 key.

F4 115

A tecla F4.The F4 key.

F5 116

A tecla F5.The F5 key.

F6 117

A tecla F6.The F6 key.

F7 118

A tecla F7.The F7 key.

F8 119

A tecla F8.The F8 key.

F9 120

A tecla F9.The F9 key.

FinalMode 24

A tecla do modo final do IME.The IME final mode key.

G 71

A tecla G.The G key.

H 72

A tecla H.The H key.

HanguelMode 21

A tecla do modo IME Hanguel.The IME Hanguel mode key. (mantida para compatibilidade, use HangulMode)(maintained for compatibility; use HangulMode)

HangulMode 21

A tecla do modo IME Hangul.The IME Hangul mode key.

HanjaMode 25

A tecla do modo IME Hanja.The IME Hanja mode key.

Help 47

A tecla HELP.The HELP key.

Home 36

A tecla HOME.The HOME key.

I 73

A tecla I.The I key.

IMEAccept 30

A tecla de aceitação do IME, substitui IMEAceept.The IME accept key, replaces IMEAceept.

IMEAceept 30

A tecla de aceitação do IME.The IME accept key. Obsoleta, use IMEAccept em seu lugar.Obsolete, use IMEAccept instead.

IMEConvert 28

A tecla de conversão do IME.The IME convert key.

IMEModeChange 31

A tecla de alteração do modo IME.The IME mode change key.

IMENonconvert 29

A tecla IME nonconvert.The IME nonconvert key.

Insert 45

A tecla INS.The INS key.

J 74

A tecla J.The J key.

JunjaMode 23

A tecla do modo IME Junja.The IME Junja mode key.

K 75

A tecla K.The K key.

KanaMode 21

A tecla do modo IME Kana.The IME Kana mode key.

KanjiMode 25

A tecla do modo IME Kanji.The IME Kanji mode key.

KeyCode 65535

O bitmask para extrair um código de tecla de um valor de tecla.The bitmask to extract a key code from a key value.

L 76

A tecla L.The L key.

LaunchApplication1 182

A tecla Iniciar Aplicativo Um (Windows 2000 ou posterior).The start application one key (Windows 2000 or later).

LaunchApplication2 183

A tecla Iniciar Aplicativo Dois (Windows 2000 ou posterior).The start application two key (Windows 2000 or later).

LaunchMail 180

A tecla Iniciar Email (Windows 2000 ou posterior).The launch mail key (Windows 2000 or later).

LButton 1

O botão esquerdo do mouse.The left mouse button.

LControlKey 162

A tecla CTRL esquerda.The left CTRL key.

Left 37

A tecla SETA PARA A ESQUERDA.The LEFT ARROW key.

LineFeed 10

A tecla LINEFEED.The LINEFEED key.

LMenu 164

A tecla ALT esquerda.The left ALT key.

LShiftKey 160

A tecla SHIFT esquerda.The left SHIFT key.

LWin 91

A tecla esquerda do logotipo do Windows (Microsoft Natural Keyboard).The left Windows logo key (Microsoft Natural Keyboard).

M 77

A tecla M.The M key.

MButton 4

O botão do meio do mouse (mouse de três botões).The middle mouse button (three-button mouse).

MediaNextTrack 176

A tecla Próxima Faixa de Mídia (Windows 2000 ou posterior).The media next track key (Windows 2000 or later).

MediaPlayPause 179

A tecla Reproduzir/Pausar Mídia (Windows 2000 ou posterior).The media play pause key (Windows 2000 or later).

MediaPreviousTrack 177

A tecla Faixa Anterior de Mídia (Windows 2000 ou posterior).The media previous track key (Windows 2000 or later).

MediaStop 178

A tecla Parar Mídia (Windows 2000 ou posterior).The media Stop key (Windows 2000 or later).

Menu 18

A tecla ALT.The ALT key.

Modifiers -65536

O bitmask para extrair os modificadores de um valor de tecla.The bitmask to extract modifiers from a key value.

Multiply 106

A tecla Multiply.The multiply key.

N 78

A tecla N.The N key.

Next 34

A tecla PAGE DOWN.The PAGE DOWN key.

NoName 252

Uma constante reservada para uso futuro.A constant reserved for future use.

None 0

Nenhuma tecla pressionada.No key pressed.

NumLock 144

A tecla NUM LOCK.The NUM LOCK key.

NumPad0 96

A tecla 0 no teclado numérico.The 0 key on the numeric keypad.

NumPad1 97

A tecla 1 no teclado numérico.The 1 key on the numeric keypad.

NumPad2 98

A tecla 2 no teclado numérico.The 2 key on the numeric keypad.

NumPad3 99

A tecla 3 no teclado numérico.The 3 key on the numeric keypad.

NumPad4 100

A tecla 4 no teclado numérico.The 4 key on the numeric keypad.

NumPad5 101

A tecla 5 no teclado numérico.The 5 key on the numeric keypad.

NumPad6 102

A tecla 6 no teclado numérico.The 6 key on the numeric keypad.

NumPad7 103

A tecla 7 no teclado numérico.The 7 key on the numeric keypad.

NumPad8 104

A tecla 8 no teclado numérico.The 8 key on the numeric keypad.

NumPad9 105

A tecla 9 no teclado numérico.The 9 key on the numeric keypad.

O 79

A tecla O.The O key.

Oem1 186

A tecla 1 do OEM.The OEM 1 key.

Oem102 226

A tecla 102 do OEM.The OEM 102 key.

Oem2 191

A tecla 2 do OEM.The OEM 2 key.

Oem3 192

A tecla 3 do OEM.The OEM 3 key.

Oem4 219

A tecla 4 do OEM.The OEM 4 key.

Oem5 220

A tecla 5 do OEM.The OEM 5 key.

Oem6 221

A tecla 6 do OEM.The OEM 6 key.

Oem7 222

A tecla 7 do OEM.The OEM 7 key.

Oem8 223

A tecla 8 do OEM.The OEM 8 key.

OemBackslash 226

A tecla de colchete angular ou barra invertida do OEM no teclado de 102 teclas RT (Windows 2000 ou posterior).The OEM angle bracket or backslash key on the RT 102 key keyboard (Windows 2000 or later).

OemClear 254

A tecla CLEAR.The CLEAR key.

OemCloseBrackets 221

A tecla de parêntese de fechamento do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM close bracket key on a US standard keyboard (Windows 2000 or later).

Oemcomma 188

A tecla de vírgula do OEM no teclado de qualquer país/região (Windows 2000 ou posterior).The OEM comma key on any country/region keyboard (Windows 2000 or later).

OemMinus 189

A tecla de menos do OEM no teclado de qualquer país/região (Windows 2000 ou posterior).The OEM minus key on any country/region keyboard (Windows 2000 or later).

OemOpenBrackets 219

A tecla de parêntese de abertura do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM open bracket key on a US standard keyboard (Windows 2000 or later).

OemPeriod 190

A tecla de ponto do OEM no teclado de qualquer país/região (Windows 2000 ou posterior).The OEM period key on any country/region keyboard (Windows 2000 or later).

OemPipe 220

A tecla de barra vertical do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM pipe key on a US standard keyboard (Windows 2000 or later).

Oemplus 187

A tecla de mais do OEM no teclado de qualquer país/região (Windows 2000 ou posterior).The OEM plus key on any country/region keyboard (Windows 2000 or later).

OemQuestion 191

A tecla de ponto de interrogação do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM question mark key on a US standard keyboard (Windows 2000 or later).

OemQuotes 222

A tecla de aspas simples/duplas do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM singled/double quote key on a US standard keyboard (Windows 2000 or later).

OemSemicolon 186

A tecla de ponto e vírgula do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM Semicolon key on a US standard keyboard (Windows 2000 or later).

Oemtilde 192

A tecla de til do OEM em um teclado padrão dos EUA (Windows 2000 ou posterior).The OEM tilde key on a US standard keyboard (Windows 2000 or later).

P 80

A tecla P.The P key.

Pa1 253

A tecla PA1.The PA1 key.

Packet 231

Usada para passar a caracteres Unicode como se fossem pressionamentos de teclas.Used to pass Unicode characters as if they were keystrokes. O valor da tecla Packet é a palavra inferior de um valor de tecla virtual de 32 bits usado para métodos de entrada diferentes do teclado.The Packet key value is the low word of a 32-bit virtual-key value used for non-keyboard input methods.

PageDown 34

A tecla PAGE DOWN.The PAGE DOWN key.

PageUp 33

A tecla PAGE UP.The PAGE UP key.

Pause 19

A tecla PAUSE.The PAUSE key.

Play 250

A tecla PLAY.The PLAY key.

Print 42

A tecla PRINT.The PRINT key.

PrintScreen 44

A tecla PRINT SCREEN.The PRINT SCREEN key.

Prior 33

A tecla PAGE UP.The PAGE UP key.

ProcessKey 229

A tecla PROCESS KEY.The PROCESS KEY key.

Q 81

A tecla Q.The Q key.

R 82

A tecla R.The R key.

RButton 2

O botão direito do mouse.The right mouse button.

RControlKey 163

A tecla CTRL direita.The right CTRL key.

Return 13

A tecla RETURN.The RETURN key.

Right 39

A tecla SETA PARA A DIREITA.The RIGHT ARROW key.

RMenu 165

A tecla ALT direita.The right ALT key.

RShiftKey 161

A tecla SHIFT direita.The right SHIFT key.

RWin 92

A tecla direita do logotipo do Windows (Microsoft Natural Keyboard).The right Windows logo key (Microsoft Natural Keyboard).

S 83

A tecla S.The S key.

Scroll 145

A tecla SCROLL LOCK.The SCROLL LOCK key.

Select 41

A tecla SELECT.The SELECT key.

SelectMedia 181

A tecla Selecionar Mídia (Windows 2000 ou posterior).The select media key (Windows 2000 or later).

Separator 108

A tecla Separador.The separator key.

Shift 65536

A tecla modificadora SHIFT.The SHIFT modifier key.

ShiftKey 16

A tecla SHIFT.The SHIFT key.

Sleep 95

A tecla de suspensão do computador.The computer sleep key.

Snapshot 44

A tecla PRINT SCREEN.The PRINT SCREEN key.

Space 32

A tecla BARRA DE ESPAÇOS.The SPACEBAR key.

Subtract 109

A tecla Subtrair.The subtract key.

T 84

A tecla T.The T key.

Tab 9

A tecla TAB.The TAB key.

U 85

A tecla U.The U key.

Up 38

A tecla SETA PARA CIMA.The UP ARROW key.

V 86

A tecla V.The V key.

VolumeDown 174

A tecla Abaixar Volume (Windows 2000 ou posterior).The volume down key (Windows 2000 or later).

VolumeMute 173

A tecla Ativar mudo (Windows 2000 ou posterior).The volume mute key (Windows 2000 or later).

VolumeUp 175

A tecla Aumentar Volume (Windows 2000 ou posterior).The volume up key (Windows 2000 or later).

W 87

A tecla W.The W key.

X 88

A tecla X.The X key.

XButton1 5

O primeiro botão x do mouse (mouse de cinco botões).The first x mouse button (five-button mouse).

XButton2 6

O segundo botão x do mouse (mouse de cinco botões).The second x mouse button (five-button mouse).

Y 89

A tecla Y.The Y key.

Z 90

A tecla Z.The Z key.

Zoom 251

A tecla ZOOM.The ZOOM key.

Exemplos

O exemplo de código a seguir KeyDown usa o evento para determinar o tipo de caractere inserido no controle.The following code example uses the KeyDown event to determine the type of character entered into the control.

   // 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

Comentários

A Keys classe contém constantes para processar a entrada do teclado.The Keys class contains constants for processing keyboard input. Os membros da enumeração de chaves consistem em um código de chave e um conjunto de modificadores combinados em um único valor inteiro.The members of the Keys enumeration consist of a key code and a set of modifiers combined into a single integer value. Na API (interface de programação de aplicativo) do Win32, um valor de chave tem duas metades, com os bits de ordem superior contendo o código de chave (que é o mesmo que um código de chave virtual do Windows) e os bits de ordem inferior que representam modificadores de chave como SHIFT, CONTROL e ALT novas.In the Win32 application programming interface (API) a key value has two halves, with the high-order bits containing the key code (which is the same as a Windows virtual key code), and the low-order bits representing key modifiers such as the SHIFT, CONTROL, and ALT keys.

Aviso

Não use os valores nesta enumeração para operações de bit de bits combinadas.Do not use the values in this enumeration for combined bitwise operations. Os valores na enumeração não são mutuamente exclusivos.The values in the enumeration are not mutually exclusive.

Observação

Essa enumeração não fornece nenhuma maneira de testar se as chaves de bloqueio CAPS LOCK ou NUM estão ativadas no momento.This enumeration provides no way to test whether the CAPS LOCK or NUM LOCK keys are currently activated. Você pode usar uma das seguintes técnicas para determinar se essas chaves estão ativadas:You can use one of the following techniques to determine if these keys are activated:

  • Chame o IsKeyLocked método Control da classe.Call the IsKeyLocked method of the Control class.

  • Para um controle mais preciso, use as funções GetKeyStateda GetAsyncKeyStateAPI do GetKeyboardState Windows, ou definidas em user32. dll, para fazer isso.For finer control, use the Windows API functions GetKeyState, GetAsyncKeyState, or GetKeyboardState defined in user32.dll, to do this. Para obter mais informações sobre como chamar funções nativas, consulte consumindo funções de dll não gerenciadas.For more information about calling native functions, see Consuming Unmanaged DLL Functions.

A tabela a seguir mostra os valores de código de chave representados por dois valores enumerados, representando as chaves de OEM (fabricante geral original do equipamento) e as associações de teclado americano mais específicas.The following table shows the key code values represented by two enumerated values, representing both the general original equipment manufacturer (OEM) keys and the more specific U.S.-keyboard associations.

Valor hexadecimalHexadecimal value Teclado americanoU.S. keyboard OEM geralGeneral OEM
BABA OemSemicolonOemSemicolon Oem1Oem1
BFBF OemQuestionOemQuestion Oem2Oem2
C0C0 OemtildeOemtilde Oem3Oem3
DBDB OemOpenBracketsOemOpenBrackets Oem4Oem4
DCDC OemPipeOemPipe Oem5Oem5
DDDD OemCloseBracketsOemCloseBrackets Oem6Oem6
DEDE OemQuotesOemQuotes Oem7Oem7
E2E2 OemBackslashOemBackslash Oem102Oem102

Cuidado

Para o .NET Framework 2,0, foi adicionado um membro IMEAccept que substitui a entrada anterior, IMEAceept, que foi digitada incorretamente.For the .NET Framework 2.0, a member IMEAccept was added that supersedes the previous entry, IMEAceept, which was spelled incorrectly. A versão mais antiga foi retida para compatibilidade com versões anteriores, mas pode ser excluída em versões futuras do .NET FrameworkThe older version has been retained for backward compatibility, but it may be deleted in future versions of the .NET Framework

Aplica-se a

Veja também