Condividi tramite


KeyEventArgs Classe

Definizione

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
Implementazioni

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:

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.

Si applica a

Vedi anche