Partage via


KeyRoutedEventArgs Classe

Définition

Fournit des données d’événement pour les événements routés KeyUp et KeyDown .

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class KeyRoutedEventArgs final : RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class KeyRoutedEventArgs : RoutedEventArgs
Public NotInheritable Class KeyRoutedEventArgs
Inherits RoutedEventArgs
Héritage
Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs
Attributs

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

L’entrée de bouton est mappée à différentes valeurs de clé pour différents appareils.

Ce tableau fournit les détails de mappage pour le pavé de jeu et les appareils distants.

Bouton

50

GamepadDPadUp/Down/Left/RightGamepadDPadUp/Down/Left/Right ou NavigationUp/Down/Left/Right
GamePad Joystick/ThumbstickGamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/Right ou NavigationUp/Down/Left/Right
Déclencheur du boîtier de commandeGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
Pare-choc/épaule du boîtier de commandeGamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
Bouton Menu du pavé de commandeGamepadMenuGamepadMenu ou NavigationMenu
Bouton Affichage du boîtier de commandeGamepadViewGamepadView ou NavigationView

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 tous les appareils connectés 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 une valeur qui marque l’événement routé comme géré. Une valeur vraie pour Handled empêche la plupart des gestionnaires le long de l’itinéraire des événements de gérer à nouveau le même événement.

Key

Obtient la clé virtuelle associée à l’événement.

Selon le périphérique d’entrée, il peut s’agir d’une valeur mappée. Pour obtenir des données d’événement brutes et non mappées, consultez la propriété OriginalKey .

KeyStatus

Obtient une valeur de structure qui signale diverses caractéristiques détectées par le système de l’appui sur la touche, y compris le nombre de répétitions et les status de menu.

OriginalKey

Obtient la clé virtuelle d’origine non maapplée associée à l’événement.

Selon le périphérique d’entrée, le bouton d’entrée peut être mappé à une autre valeur de clé. Pour connaître la valeur de l’événement mappé, consultez la propriété Key .

OriginalSource

Obtient une référence à l’objet qui a déclenché l’événement. Il s’agit souvent d’un modèle faisant partie d’un contrôle plutôt que d’un élément qui a été déclaré dans l’interface utilisateur de votre application.

(Hérité de RoutedEventArgs)

S’applique à

Voir aussi