Freigeben über


KeyRoutedEventArgs Klasse

Definition

Stellt Ereignisdaten für die Weitergeleiteten Ereignisse KeyUp und KeyDown bereit.

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
Vererbung
Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die Schaltflächeneingabe wird verschiedenen Schlüsselwerten für verschiedene Geräte zugeordnet.

Diese Tabelle enthält die Zuordnungsdetails für Spielpads und Remotegeräte.

Schaltfläche

50

GamepadDPadUp/Down/Left/RightGamepadDPadUp/Down/Left/Right oder NavigationUp/Down/Left/Right
GamePad Joystick/ThumbstickGamepadLeftThumbstickButton/Up/Down/Left/Right oder GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right or GamepadRightThumbstickButton/Up/Down/Left/Right or NavigationUp/Down/Left/Right
Gamepad-TriggerGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
Gamepad-Bumper/SchulterGamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
Schaltfläche GamepadMenuGamepadMenü oder NavigationMenü
Schaltfläche GamepadViewGamepadView oder NavigationView

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1607 14393 deviceId

Eigenschaften

DeviceId

Ruft eine eindeutige ID für das Eingabegerät ab, das dieses Schlüsselereignis generiert hat.

Verwenden Sie DeviceId, um zwischen allen verbundenen Geräten zu unterscheiden, die wichtige Ereignisse generieren können, z. B. mehrere Gamecontroller.

DeviceId wird nicht für alle Eingabegeräte unterstützt.

Handled

Ruft einen Wert ab, der das Routingereignis als behandelt markiert, oder legt diesen fest. Ein true-Wert für Handled verhindert, dass die meisten Handler entlang der Ereignisroute dasselbe Ereignis erneut behandeln.

Key

Ruft den virtuellen Schlüssel ab, der dem Ereignis zugeordnet ist.

Abhängig vom Eingabegerät kann dies ein zugeordneter Wert sein. Unformatierte, nicht zugeordnete Ereignisdaten finden Sie in der OriginalKey-Eigenschaft .

KeyStatus

Ruft einen Strukturwert ab, der verschiedene vom System erkannte Merkmale des Tastendrucks meldet, einschließlich Wiederholungsanzahl und Menü status.

OriginalKey

Ruft den ursprünglichen, nicht zugeordneten virtuellen Schlüssel ab, der dem Ereignis zugeordnet ist.

Je nach Eingabegerät kann die Eingabeschaltfläche einem anderen Schlüsselwert zugeordnet werden. Den zugeordneten Ereigniswert finden Sie in der Key-Eigenschaft .

OriginalSource

Ruft einen Verweis auf das -Objekt ab, das das -Ereignis ausgelöst hat. Dies ist häufig ein Vorlagenteil eines Steuerelements und nicht ein Element, das in der App-Benutzeroberfläche deklariert wurde.

(Geerbt von RoutedEventArgs)

Gilt für:

Weitere Informationen