KeyEventArgs Classe

Référence

Définition

Espace de noms:: Windows.UI.Core

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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 :

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 à

Partager via