Compartir a través de


UIElement.KeyDown Evento

Definición

Se produce cuando se presiona una tecla de teclado mientras uiElement tiene el foco.

public:
 virtual event KeyEventHandler ^ KeyDown;
// Register
event_token KeyDown(KeyEventHandler const& handler) const;

// Revoke with event_token
void KeyDown(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;
public event KeyEventHandler KeyDown;
function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;
Public Custom Event KeyDown As KeyEventHandler 
<uiElement KeyDown="eventhandler"/>

Tipo de evento

Comentarios

Los controles de la interfaz de usuario generan eventos de teclado solo cuando tienen el foco de entrada. De forma predeterminada, el sistema asigna el foco al primer elemento que se puede centrar en el árbol visual. Un control individual obtiene el foco cuando el usuario hace clic o pulsa directamente en ese control en el diseño o usa la tecla Tab para entrar en una secuencia de tabulación dentro del área de contenido. También puedes centrar los controles mediante programación llamando a UIElement.Focus(Microsoft.UI.Xaml.FocusState).

KeyDown es un evento enrutado. Para obtener más información sobre el concepto de evento enrutado, consulta Información general sobre eventos y eventos enrutados.

KeyDown usa los datos del evento KeyRoutedEventArgs . Las propiedades más relevantes de para la mayoría de KeyRoutedEventArgs los escenarios de controlador son Key y posiblemente KeyStatus. Para obtener más información sobre cómo controlar eventos de teclado, incluido el código de ejemplo para definir un método KeyEventHandler , consulta Interacciones de teclado.

Un escenario para controlar eventos de teclado es admitir teclas de acceso o teclas de aceleración para una aplicación, o una región o un control dentro de una aplicación. Para obtener más información sobre este escenario, consulta Accesibilidad del teclado.

Los controles de Windows Runtime específicos pueden tener control basado en clases para el evento de entrada KeyDown. Si es así, es probable que el control tenga una invalidación para el método OnKeyDown. Normalmente, estos controladores de clase están diseñados para procesar un subconjunto de pulsaciones de teclas que permiten la interacción del usuario basada en teclado con ese control. A menudo, esta interacción admite una característica de accesibilidad de teclado. Si el control basado en clases controla una pulsación de teclas, se considera que la pulsación de teclas ya está controlada y el evento KeyDown no se genera para controlarlo ningún controlador de código de usuario en ese control para esa tecla específicamente. Normalmente, esto es solo para algunas claves dedicadas. Por ejemplo, ButtonBase tiene control de clases para que la tecla Espaciadora y la tecla Entrar se controlen como equivalentes de teclado para invocar el botón. Esto proporciona un teclado integrado equivalente para pulsar el botón o hacer clic en él con un mouse y permite el escenario de accesibilidad de usar la interfaz de usuario y el botón solo con un teclado. Pero cualquier otra clave que no sea Space o Enter seguirá activando un evento KeyDown y KeyUp para .Button Para obtener más información sobre cómo funciona el control basado en clases de eventos, consulte Información general sobre eventos y eventos enrutados.

KeyDown admite la capacidad de adjuntar controladores de eventos a la ruta que se invocará incluso si los datos del evento se marcan como Handled. Consulte AddHandler.

Se aplica a

Consulte también