Partage via


KeyEventArgs Classe

Définition

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
Implémente

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 :

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.

S’applique à

Voir aussi