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)

Комментарии

Ввод кнопки сопоставляется с разными значениями ключей для различных устройств.

В этой таблице приведены сведения о сопоставлении для игровой площадки и удаленных устройств.

Кнопка

50

GamepadDPadUp/Down/Left/RightGamepadDPadUp/Down/Left/Right или NavigationUp/Down/Left/Right
Джойстик GamePad/ThumbstickGamepadLeftThumbstickButton/Up/Down/Left/Right или GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right или GamepadRightThumbstickButton/Up/Down/Left/Right или NavigationUp/Down/Down/Left/Right
Триггер геймпадаGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
Бампер геймпада/плечоGamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
Кнопка меню геймпадаGamepadMenuGamepadMenu или NavigationMenu
Кнопка GamepadViewGamepadView или NavigationView

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 deviceId

Свойства

DeviceId

Получает уникальный идентификатор устройства ввода, создающего это ключевое событие.

Используйте DeviceId, чтобы различать все подключенные устройства, которые могут генерировать события ключей, например несколько игровых контроллеров.

DeviceId поддерживается не для всех устройств ввода.

Handled

Возвращает или задает значение, которое помечает перенаправленное событие как обработанное. Значение true для Handled предотвращает повторную обработку того же события большинством обработчиков по маршруту событий.

Key

Возвращает виртуальный ключ , связанный с событием.

В зависимости от устройства ввода это может быть сопоставленное значение. Необработанные несопоставленные данные о событиях см. в свойстве OriginalKey .

KeyStatus

Возвращает значение структуры, которое сообщает о различных обнаруженных системой характеристиках нажатия клавиши, включая количество повторов и состояние меню.

OriginalKey

Возвращает исходный несопоставленный виртуальный ключ , связанный с событием.

В зависимости от устройства ввода кнопка ввода может быть сопоставлена с другим значением ключа. Значение сопоставленного события см. в свойстве Key .

OriginalSource

Возвращает ссылку на объект, который вызвал событие. Часто это часть шаблона элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения.

(Унаследовано от RoutedEventArgs)

Применяется к

См. также раздел