KeyEventArgs Clase

Definición

Espacio de nombres:

Windows.UI.Core

Contiene los argumentos devueltos por un evento de clave virtual.

public ref class KeyEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class KeyEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class KeyEventArgs

Public NotInheritable Class KeyEventArgs

Herencia

Object Platform::Object IInspectable KeyEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

ICoreWindowEventArgs

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Windows 10 Aplicaciones no reciben este evento cuando se habilita un Editor de métodos de entrada (IME). El Editor de métodos de entrada (IME) controla todas las entradas de teclado y establece Handled entrue.

Windows Phone Esta API solo se admite en aplicaciones nativas.

Un delegado registrado para uno de los siguientes eventos devuelve este objeto:

• CoreWindow.KeyDown
• CoreWindow.KeyUp

void SetWindow(CoreWindow const & window)
{
    ...
    window.KeyDown({ this, &App::OnKeyDown });
    window.KeyUp({ this, &App::OnKeyUp });
}

// Keypress data is in KeyEventArgs.
void OnKeyDown(Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::KeyEventArgs const& /* args */) {}

void OnKeyUp(Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::KeyEventArgs const& /* args */) {}

// returning keypress events data through KeyEventArgs
void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication::Run(), provided for context
    _In_ CoreWindow^ window
    )
{
    // ...
    window->KeyDown +=
        ref new TypedEventHandler<CoreWindow^, KeyEventArgs^>(this, &CoreWindowEvents::OnKeyDown);
    window->KeyUp +=
        ref new TypedEventHandler<CoreWindow^, KeyEventArgs^>(this, &CoreWindowEvents::OnKeyUp);

    // ...
}

Nota

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulta Subprocesos y serialización (C++/CX).

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	deviceId

Propiedades

DeviceId	Obtiene un identificador único para el dispositivo de entrada que generó este evento de clave. Usa DeviceId para diferenciar entre los dispositivos que pueden generar eventos clave, como varios controladores de juego. DeviceId no se admite para todos los dispositivos de entrada.
Handled	Obtiene o establece si se controló el evento de presión de teclas.
KeyStatus	Obtiene el estado de una clave en el momento en que se desencadena el evento.
VirtualKey	Obtiene la clave virtual que se asigna a la tecla que se presionó.

Consulte también

• KeyDown
• KeyUp