Compartir a través de

Uso de eventos de teclado

La mayoría de los programas de Windows Forms procesan la entrada del teclado controlando los eventos de teclado. En este artículo se proporciona información general sobre los eventos de teclado, incluidos los detalles sobre cuándo usar cada evento y los datos proporcionados para cada evento. Para obtener más información sobre los eventos en general, vea Información general sobre eventos.

Eventos de teclado

Windows Forms proporciona dos eventos que se producen cuando un usuario presiona una tecla de teclado y un evento cuando un usuario suelta una tecla de teclado:

  • El KeyDown evento se produce una vez.
  • Evento KeyPress , que puede producirse varias veces cuando un usuario mantiene presionada la misma clave.
  • El KeyUp evento se produce una vez cuando un usuario libera una clave.

Cuando un usuario presiona una tecla, Windows Forms determina qué evento se va a generar en función de si el mensaje de teclado especifica una tecla de carácter o una tecla física. Para obtener más información sobre el carácter y las teclas físicas, vea Introducción al teclado , eventos de teclado.

En la tabla siguiente se describen los tres eventos de teclado.

Evento de teclado Descripción Resultados
KeyDown Este evento se genera cuando un usuario presiona una tecla física. El controlador para KeyDown recibe:

  • Parámetro KeyEventArgs , que proporciona la KeyCode propiedad (que especifica un botón de teclado físico).
  • La Modifiers propiedad (MAYÚS, CTRL o ALT).
  • La KeyData propiedad (que combina el código de clave y el modificador). El KeyEventArgs parámetro también proporciona:

    • La Handled propiedad , que se puede establecer para impedir que el control subyacente reciba la clave.
    • La propiedad SuppressKeyPress, que se puede usar para suprimir los eventos KeyPress y KeyUp para esa pulsación de tecla.
KeyPress Este evento se genera cuando la tecla o las teclas presionadas dan como resultado un carácter. Por ejemplo, un usuario presiona la tecla MAYÚS junto con la tecla "a" minúscula, lo que da como resultado el carácter "A" en mayúscula. KeyPress se activa después de KeyDown.

  • El controlador para KeyPress recibe:
  • Parámetro KeyPressEventArgs , que contiene el código de carácter de la tecla que se presionó. Este código de carácter es único para cada combinación de una tecla de carácter y una tecla modificadora.

    Por ejemplo, la clave "A" genera:

    • El código de carácter 65, si se presiona con la tecla Mayús
    • O el bloqueo de mayúsculas está encendido, 97 si está presionada por sí sola.
    • Y 1, si se presiona con la tecla Ctrl .
KeyUp Este evento se genera cuando un usuario libera una clave física. El controlador para KeyUp recibe:

  • Parámetro KeyEventArgs :

    • Que proporciona la KeyCode propiedad (que especifica un botón de teclado físico).
    • La Modifiers propiedad (MAYÚS, CTRL o ALT).
    • La KeyData propiedad (que combina el código de clave y el modificador).

Consulte también