UIElement.KeyDown Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 en el árbol visual. Un control individual obtiene el foco cuando el usuario hace clic o presiona directamente sobre dicho control en el diseño o bien usa la tecla TAB para entrar en una secuencia de tabulación dentro del área de contenido. También puede centrar los controles mediante programación llamando a Control.Focus.
KeyDown es un evento enrutado. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.
KeyDown usa los datos del evento KeyRoutedEventArgs . Las propiedades más importantes de KeyRoutedEventArgs para la mayoría de los escenarios de controladores 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 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í, el control probablemente tiene 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 una interacción de usuario basada en teclado con ese control y, 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á administrada 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 Espacio y la tecla Entrar se controlan 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 con un solo teclado. Pero cualquier otra tecla que no sea Space o Enter seguirá activando un evento KeyDown y KeyUp para un Button. Para obtener más información sobre cómo funciona el control basado en clases para eventos, consulta 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 Controlado. Consulte AddHandler.