Este tema aún no ha recibido ninguna valoración - Valorar este tema

Keys (Enumeración)

.NET Framework 3.5

Otras versiones

Actualización: noviembre 2007

Especifica los modificadores y códigos de tecla.

Esta enumeración tiene un atributo ComVisibleAttribute que permite una combinación bit a bit de los valores de miembro.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)

Sintaxis

C++

Copiar

[ComVisibleAttribute(true)]
[FlagsAttribute]
[TypeConverterAttribute(typeof(KeysConverter))]
public enum Keys

Copiar

/** @attribute ComVisibleAttribute(true) */
/** @attribute FlagsAttribute */
/** @attribute TypeConverterAttribute(KeysConverter) */
public enum Keys

JScript

Copiar

public enum Keys

Miembros

	Nombre de miembro	Descripción
	KeyCode	Máscara de bits para extraer un código de tecla de un valor de tecla.
	Modifiers	Máscara de bits para extraer modificadores de un valor de tecla.
	None	Ninguna tecla presionada.
	LButton	Botón primario del mouse.
	RButton	Botón secundario del mouse.
	Cancel	Tecla CANCELAR.
	MButton	Botón central del mouse (mouse de tres botones).
	XButton1	Primer botón x del mouse (mouse de cinco botones).
	XButton2	Segundo botón x del mouse (mouse de cinco botones).
	Back	Tecla RETROCESO.
	Tab	Tecla TAB.
	LineFeed	Tecla AVANCE DE LÍNEA.
	Clear	Tecla BORRAR.
	Return	Tecla RETORNO.
	Enter	Tecla ENTRAR.
	ShiftKey	Tecla MAYÚS.
	ControlKey	Tecla CTRL.
	Menu	Tecla ALT.
	Pause	Tecla PAUSA.
	Capital	Tecla BLOQ MAYÚS.
	CapsLock	Tecla BLOQ MAYÚS.
	KanaMode	Tecla de modo Kana de Editores de métodos de entrada (IME).
	HanguelMode	Tecla de modo Hanguel de Editores de métodos de entrada (IME) (se mantiene por compatibilidad; use HangulMode).
	HangulMode	Tecla de modo Hangul de Editores de métodos de entrada (IME).
	JunjaMode	Tecla de modo Junja de Editores de métodos de entrada (IME).
	FinalMode	Tecla de modo final de Editores de métodos de entrada (IME).
	HanjaMode	Tecla de modo Hanja de Editores de métodos de entrada (IME).
	KanjiMode	Tecla de modo Kanji de Editores de métodos de entrada (IME).
	Escape	Tecla ESC.
	IMEConvert	Tecla convertir de Editores de métodos de entrada (IME).
	IMENonconvert	Tecla no convertir de Editores de métodos de entrada (IME).
	IMEAccept	Tecla aceptar de Editores de métodos de entrada (IME), reemplaza a IMEAceept.
	IMEAceept	Tecla aceptar de Editores de métodos de entrada (IME). Obsoleto, utilice IMEAccept en su lugar.
	IMEModeChange	Tecla cambio de modo de Editores de métodos de entrada (IME).
	Space	Tecla BARRA ESPACIADORA.
	Prior	Tecla RE PÁG.
	PageUp	Tecla RE PÁG.
	Next	Tecla AV PÁG.
	PageDown	Tecla AV PÁG.
	End	Tecla FIN.
	Home	Tecla INICIO.
	Left	Tecla FLECHA IZQUIERDA.
	Up	Tecla FLECHA ARRIBA.
	Right	Tecla FLECHA DERECHA.
	Down	Tecla FLECHA ABAJO.
	Select	Tecla SELECCIONAR.
	Print	Tecla IMPRIMIR.
	Execute	Tecla EJECUTAR.
	Snapshot	Tecla IMPR PANT.
	PrintScreen	Tecla IMPR PANT.
	Insert	Tecla INSERT.
	Delete	Tecla SUPR.
	Help	Tecla AYUDA.
	D0	Tecla 0.
	D1	Tecla 1.
	D2	Tecla 2.
	D3	Tecla 3.
	D4	Tecla 4.
	D5	Tecla 5.
	D6	Tecla 6.
	D7	Tecla 7.
	D8	Tecla 8.
	D9	Tecla 9.
	A	Tecla A.
	B	Tecla B.
	C	Tecla C.
	D	Tecla D.
	E	Tecla E.
	F	Tecla F.
	G	Tecla G.
	H	Tecla H.
	I	Tecla I.
	J	Tecla J.
	K	Tecla K.
	L	Tecla L.
	M	Tecla M.
	N	Tecla N.
	O	Tecla O.
	P	Tecla P.
	Q	Tecla Q.
	R	Tecla R.
	S	Tecla S.
	T	Tecla T.
	U	Tecla U.
	V	Tecla V.
	W	Tecla W.
	X	Tecla X.
	Y	Tecla Y.
	Z	Tecla Z.
	LWin	Tecla izquierda con el logotipo de Windows (Microsoft Natural Keyboard).
	RWin	Tecla derecha con el logotipo de Windows (Microsoft Natural Keyboard).
	Apps	Tecla aplicación (Microsoft Natural Keyboard).
	Sleep	La tecla de espera del equipo.
	NumPad0	Tecla 0 del teclado numérico.
	NumPad1	Tecla 1 del teclado numérico.
	NumPad2	Tecla 2 del teclado numérico.
	NumPad3	Tecla 3 del teclado numérico.
	NumPad4	Tecla 4 del teclado numérico.
	NumPad5	Tecla 5 del teclado numérico.
	NumPad6	Tecla 6 del teclado numérico.
	NumPad7	Tecla 7 del teclado numérico.
	NumPad8	Tecla 8 del teclado numérico.
	NumPad9	Tecla 9 del teclado numérico.
	Multiply	Tecla multiplicación.
	Add	Tecla agregar.
	Separator	Tecla separador.
	Subtract	Tecla resta.
	Decimal	Tecla decimal.
	Divide	Tecla división.
	F1	Tecla F1.
	F2	Tecla F2.
	F3	Tecla F3.
	F4	Tecla F4.
	F5	Tecla F5.
	F6	Tecla F6.
	F7	Tecla F7.
	F8	Tecla F8.
	F9	Tecla F9.
	F10	Tecla F10.
	F11	Tecla F11.
	F12	Tecla F12.
	F13	Tecla F13.
	F14	Tecla F14.
	F15	Tecla F15.
	F16	Tecla F16.
	F17	Tecla F17.
	F18	Tecla F18.
	F19	Tecla F19.
	F20	Tecla F20.
	F21	Tecla F21.
	F22	Tecla F22.
	F23	Tecla F23.
	F24	Tecla F24.
	NumLock	Tecla BLOQ NUM.
	Scroll	Tecla BLOQ DESPL.
	LShiftKey	Tecla MAYÚS izquierda.
	RShiftKey	Tecla MAYÚS derecha.
	LControlKey	Tecla CTRL izquierda.
	RControlKey	Tecla CTRL derecha.
	LMenu	Tecla ALT izquierda.
	RMenu	Tecla ALT derecha.
	BrowserBack	Tecla atrás del explorador (Windows 2000 o posterior).
	BrowserForward	Tecla adelante del explorador (Windows 2000 o posterior).
	BrowserRefresh	Tecla actualizar del explorador (Windows 2000 o posterior).
	BrowserStop	Tecla detener del explorador (Windows 2000 o posterior).
	BrowserSearch	Tecla búsqueda del explorador (Windows 2000 o posterior).
	BrowserFavorites	Tecla favoritos del explorador (Windows 2000 o posterior).
	BrowserHome	Tecla inicio del explorador (Windows 2000 o posterior).
	VolumeMute	Tecla silenciar el volumen (Windows 2000 o posterior).
	VolumeDown	Tecla bajar el volumen (Windows 2000 o posterior).
	VolumeUp	Tecla subir el volumen (Windows 2000 o posterior).
	MediaNextTrack	Tecla siguiente pista de multimedia (Windows 2000 o posterior).
	MediaPreviousTrack	Tecla pista anterior de multimedia (Windows 2000 o posterior).
	MediaStop	Tecla Detener reproducción de multimedia (Windows 2000 o posterior).
	MediaPlayPause	Tecla pausa de reproducción de multimedia (Windows 2000 o posterior).
	LaunchMail	Tecla iniciar correo (Windows 2000 o posterior).
	SelectMedia	Tecla seleccionar reproducción de multimedia (Windows 2000 o posterior).
	LaunchApplication1	Tecla iniciar aplicación uno (Windows 2000 o posterior).
	LaunchApplication2	Tecla iniciar aplicación dos (Windows 2000 o posterior).
	OemSemicolon	Tecla de punto y coma OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem1	Tecla 1 OEM.
	Oemplus	Tecla de signo más OEM en un teclado de cualquier país o región (Windows 2000 o posterior).
	Oemcomma	Tecla de coma OEM en un teclado de cualquier país o región (Windows 2000 o posterior).
	OemMinus	Tecla menos OEM en un teclado de cualquier país o región (Windows 2000 o posterior).
	OemPeriod	Tecla de punto OEM en un teclado de cualquier país o región (Windows 2000 o posterior).
	OemQuestion	Tecla de signo de interrogación OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem2	Tecla 2 OEM.
	Oemtilde	Tecla de tilde OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem3	Tecla 3 OEM.
	OemOpenBrackets	Tecla de corchete de apertura OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem4	Tecla 4 OEM.
	OemPipe	Tecla de barra vertical OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem5	Tecla 5 OEM.
	OemCloseBrackets	Tecla de corchete de cierre OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem6	Tecla 6 OEM.
	OemQuotes	Tecla de comillas simples y dobles OEM en un teclado US estándar (Windows 2000 o posterior).
	Oem7	Tecla 7 OEM.
	Oem8	Tecla 8 OEM.
	OemBackslash	Tecla de corchete angular o barra diagonal inversa OEM en el teclado RT de 102 teclas (Windows 2000 o posterior).
	Oem102	Tecla 102 OEM.
	ProcessKey	Tecla PROCESS KEY.
	Packet	Se utiliza para pasar caracteres Unicode como si fueran pulsaciones de tecla. El valor de la clave de paquete es la palabra baja de un valor de tecla virtual de 32 bits utilizado para métodos de entrada sin teclado.
	Attn	Tecla ATTN.
	Crsel	Tecla CRSEL.
	Exsel	Tecla EXSEL.
	EraseEof	Tecla ERASE EOF.
	Play	Tecla REPRODUCIR.
	Zoom	Tecla ZOOM.
	NoName	Constante reservada para un uso futuro.
	Pa1	Tecla PA1.
	OemClear	Tecla BORRAR.
	Shift	Tecla modificadora MAYÚS.
	Control	Tecla modificadora CTRL.
	Alt	Tecla modificadora ALT.

Comentarios

La clase Keys contiene las constantes para procesar las acciones del teclado. Los miembros de la enumeración Keys constan de un código de tecla y un conjunto de modificadores combinados en un valor entero único. En la interfaz de programación de la aplicación Win32 (API) un valor de tecla tiene dos mitades: los bits de orden superior contienen el código de tecla (que es igual que un código de tecla virtual de Windows) y los bits de orden inferior representan los modificadores de la tecla, como las teclas MAYÚS, CONTROL y ALT.

Nota:
Esta enumeración no proporciona ninguna manera de probar si las teclas BLOQ MAYÚS o BLOQ NUM están activadas actualmente. Puede utilizar una de las técnicas siguientes para determinar si se activan estas claves:

Llame al método IsKeyLocked de la clase Control.
Para un control más riguroso, utilice las funciones de la API Win32 GetKeyState, GetAsyncKeyState o GetKeyboardState definidas para ello en user32.dll. Para obtener más información sobre cómo llamar a las funciones nativas, vea Consumir funciones DLL no administradas.

La tabla siguiente muestra los valores de código de tecla representados por dos valores enumerados, que representan las teclas generales del fabricante de equipos originales (OEM) y las asociaciones más específicas del teclado americano.

Valor hexadecimal	Teclado americano	OEM General
BA	OemSemicolon	Oem1
BF	OemQuestion	Oem2
C0	Oemtilde	Oem3
DB	OemOpenBrackets	Oem4
DC	OemPipe	Oem5
DD	OemCloseBrackets	Oem6
DE	OemQuotes	Oem7
E2	OemBackslash	Oem102

Precaución:
Para .NET Framework 2.0, se agregó un miembro IMEAccept que reemplaza la entrada anterior, IMEAceept, que se había deletreado incorrectamente. La versión anterior se ha conservado por compatibilidad con versiones anteriores, pero puede eliminarse en versiones futuras de .NET Framework

Ejemplos

En el ejemplo de código siguiente se utiliza el evento KeyDown para determinar el tipo de carácter escrito en el control.

C++

Copiar

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

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

Copiar

// Boolean flag used to determine when a character other than a number 
// is entered.
private boolean 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.get_KeyCode().CompareTo(Keys.D0)) < 0 
        || (e.get_KeyCode().CompareTo(Keys.D9) > 0)) {

        // Determine whether the keystroke is a number from the keypad.
        if ((e.get_KeyCode().CompareTo(Keys.NumPad0) < 0 
            || (e.get_KeyCode().CompareTo(Keys.NumPad9)) > 0)) {

            // Determine whether the keystroke is a backspace.
            if (!(e.get_KeyCode().Equals(Keys.Back))) {
                    // A non-numerical keystroke was pressed.
                    // Set the flag to true and evaluate in KeyPress event.
                    nonNumberEntered = true;
            }
        }
    }
} //textBox1_KeyDown

// 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.set_Handled(true);
    }
} //textBox1_KeyPress

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión