KeyEventArgs Classe

Definizione

Spazio dei nomi:

Windows.UI.Core

Contiene gli argomenti restituiti da un evento di chiave virtuale.

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

Ereditarietà

Object Platform::Object IInspectable KeyEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

ICoreWindowEventArgs

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Windows 10 Le app non ricevono questo evento quando è abilitato un IME (Input Method Editor). Input Method Editor (IME) gestisce tutti gli input della tastiera e imposta Handled su true.

Windows Phone Questa API è supportata solo nelle app native.

Questo oggetto viene restituito da un delegato registrato per uno degli eventi seguenti:

• 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

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre info, vedi Threading e marshalling (C++/CX).

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	DeviceId

Proprietà

DeviceId	Ottiene un ID univoco per il dispositivo di input che ha generato questo evento chiave. Usare DeviceId per distinguere i dispositivi che possono generare eventi chiave, ad esempio più controller di gioco. DeviceId non è supportato per tutti i dispositivi di input.
Handled	Ottiene o imposta un valore che indica se l'evento di pressione del tasto è stato gestito.
KeyStatus	Ottiene lo stato di una chiave al momento della generazione dell'evento.
VirtualKey	Ottiene il tasto virtuale mappato al tasto premuto.

Vedi anche

• KeyDown
• KeyUp