Language

KeyRoutedEventArgs クラス

定義

名前空間:
Microsoft.UI.Xaml.Input
編集

KeyUp および KeyDown ルーティング イベントのイベント データを提供します。

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

ボタン入力は、ゲーム コントローラーを含むさまざまなデバイスのさまざまなキー値にマップされます。

次の表は、ゲーム コントローラーのマッピングの詳細を示しています。

Button キー 値 OriginalKey 値
GamepadA ボタン 宇宙GamepadA または NavigationAccept
GamepadB ボタン 逃げるGamepadB または NavigationCancel
GamepadX ボタン GamepadXGamepadX
GamepadY ボタン GamepadYGamepadY
GamepadDPad ボタン

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

プロパティ

名前 説明
DeviceId

このキー イベントを生成した入力デバイスの一意の ID を取得します (すべての入力デバイスでサポートされているわけではありません)。
Handled

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

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

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

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

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

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

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

(継承元 RoutedEventArgs)

適用対象

こちらもご覧ください