KeyRoutedEventArgs 클래스

정의

네임스페이스:

Windows.UI.Xaml.Input

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

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

단추 입력은 다양한 디바이스의 다양한 키 값에 매핑됩니다.

이 표에서는 게임 패드 및 원격 디바이스에 대한 매핑 세부 정보를 제공합니다.

단추	50	GamepadDPadUp/Down/Left/Right	GamepadDPadUp/아래쪽/왼쪽/오른쪽 또는 NavigationUp/아래쪽/왼쪽/오른쪽
	GamepadLeftThumbstickButton/Up/Down/Left/Right 또는 GamepadRightThumbstickButton/Up/Down/Left/Right	GamepadLeftThumbstickButton/Up/Down/Left/Right 또는 GamepadRightThumbstickButton/Up/Down/Left/Right 또는 NavigationUp/Down/Left/Right
	GamePadRightTrigger/LeftTrigger	GamePadRightTrigger/LeftTrigger
	GamePadRightShoulder/LeftShoulder	GamePadRightShoulder/LeftShoulder
	GamepadMenu	GamepadMenu 또는 NavigationMenu
	GamepadView	GamepadView 또는 NavigationView

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	DeviceId

속성

DeviceId	이 키 이벤트를 생성한 입력 디바이스의 고유 ID를 가져옵니다. DeviceId를 사용하여 여러 게임 컨트롤러와 같은 주요 이벤트를 생성할 수 있는 연결된 모든 디바이스를 구분합니다. DeviceId는 모든 입력 디바이스에서 지원되지 않습니다.
Handled	라우트된 이벤트를 처리됨으로 표시하는 값을 가져오거나 설정합니다. Handled의 true 값은 이벤트 경로의 대부분의 처리기가 동일한 이벤트를 다시 처리하지 못하도록 합니다.
Key	이벤트와 연결된 가상 키를 가져옵니다. 입력 디바이스에 따라 매핑된 값일 수 있습니다. 매핑되지 않은 원시 이벤트 데이터는 OriginalKey 속성을 참조하세요.
KeyStatus	반복 횟수 및 메뉴 상태 포함하여 키 누름의 다양한 시스템 검색 특성을 보고하는 구조체 값을 가져옵니다.
OriginalKey	이벤트와 연결된 매핑되지 않은 원래 가상 키를 가져옵니다. 입력 디바이스에 따라 입력 단추가 다른 키 값에 매핑될 수 있습니다. 매핑된 이벤트 값은 Key 속성을 참조하세요.
OriginalSource	이벤트를 발생시킨 개체에 대한 참조를 가져옵니다. 앱 UI에서 선언된 요소가 아닌 컨트롤의 템플릿 부분입니다. (다음에서 상속됨 RoutedEventArgs)

추가 정보

• RoutedEventArgs
• XAML WebView 컨트롤 샘플