KeyEventArgs Classe

Définition

Espace de noms:

Windows.UI.Core

Contient les arguments retournés par un événement de clé virtuelle.

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

Héritage

Object Platform::Object IInspectable KeyEventArgs

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

ICoreWindowEventArgs

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Windows 10 Apps ne reçoivent pas cet événement lorsqu’un éditeur de méthode d’entrée (IME) est activé. L’éditeur de méthode d’entrée (IME) gère toutes les entrées du clavier et définit Handled sur true.

Windows Phone Cette API est prise en charge uniquement dans les applications natives.

Cet objet est retourné par un délégué inscrit pour l’un des événements suivants :

• 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);

    // ...
}

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX).

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	deviceId

Propriétés

DeviceId	Obtient un ID unique pour l’appareil d’entrée qui a généré cet événement clé. Utilisez DeviceId pour différencier les appareils qui peuvent générer des événements clés, tels que plusieurs contrôleurs de jeu. DeviceId n’est pas pris en charge pour tous les appareils d’entrée.
Handled	Obtient ou définit si l’événement d’appui sur la touche a été géré.
KeyStatus	Obtient la status d’une clé au moment où l’événement est déclenché.
VirtualKey	Obtient la clé virtuelle qui mappe à la touche qui a été enfoncée.

Voir aussi

• KeyDown
• KeyUp