KeyRoutedEventArgs クラス

定義

KeyUp および 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
継承
Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

ボタン入力は、さまざまなデバイスのさまざまなキー値にマップされます。

次の表は、ゲーム パッドとリモート デバイスのマッピングの詳細を示しています。

Button

50

GamepadDPadUp/Down/Left/RightGamepadDPadUp/Down/Left/Right または NavigationUp/Down/Left/Right
GamePad ジョイスティック/サムスティックGamepadLeftThumbstickButton/Up/Down/Left/Right または GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right または GamepadRightThumbstickButton/Up/Down/Left/Right または NavigationUp/Down/Left/Right
ゲームパッド トリガーGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
ゲームパッドのバンパー/ショルダーGamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
[ゲームパッド] メニュー ボタンGamepadMenuGamepadMenu または NavigationMenu
[ゲームパッドの表示] ボタンGamepadViewGamepadView または NavigationView

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 deviceId

プロパティ

DeviceId

このキー イベントを生成した入力デバイスの一意の ID を取得します。

DeviceId を使用して、複数のゲーム コントローラーなど、主要なイベントを生成できる接続されているすべてのデバイスを区別します。

DeviceId は、すべての入力デバイスでサポートされているわけではありません。

Handled

ルーティング イベントを処理済みとしてマークする値を取得または設定します。 Handledtrue 値を指定すると、イベント ルートに沿ったほとんどのハンドラーが同じイベントを再び処理できなくなります。

Key

イベントに関連付けられている 仮想キー を取得します。

入力デバイスに応じて、これはマップされた値にすることができます。 未加工のマップされていないイベント データについては、 OriginalKey プロパティを参照してください。

KeyStatus

繰り返し数やメニューの状態など、キー押下のさまざまなシステム検出特性を報告する構造体値を取得します。

OriginalKey

イベントに関連付けられている元のマップされていない 仮想キー を取得します。

入力デバイスによっては、入力ボタンが別のキー値にマップされる場合があります。 マップされたイベント値については、 Key プロパティを参照してください。

OriginalSource

イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。

(継承元 RoutedEventArgs)

適用対象

こちらもご覧ください