Compartir a través de


KeyEventArgs Clase

Definición

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
Implementaciones

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:

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ó.

Se aplica a

Consulte también