다음을 통해 공유


KeyRoutedEventArgs 클래스

정의

KeyUpKeyDown 라우트된 이벤트에 대한 이벤트 데이터를 제공합니다.

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/아래쪽/왼쪽/오른쪽 또는 NavigationUp/아래쪽/왼쪽/오른쪽
게임 패드 조이스틱/엄지스틱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)

적용 대상

추가 정보