다음을 통해 공유


Windows.UI.Input 네임스페이스

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.

클래스

AttachableInputObject

창, 뷰 또는 기타 시각적 요소와 연결된 InputActivationListener 개체의 기본 클래스입니다.

CrossSlidingEventArgs

CrossSliding 이벤트에 대한 이벤트 데이터를 포함합니다.

DraggingEventArgs

끌기 이벤트에 대한 이벤트 데이터를 포함합니다.

EdgeGesture

에지 기반 UI에 대한 트리거를 앱에 알리는 이벤트에 대한 액세스를 제공합니다.

EdgeGestureEventArgs

에지 제스처 이벤트를 트리거한 사용자 입력 유형에 대한 액세스를 제공합니다.

GestureRecognizer

제스처 및 조작 인식, 이벤트 수신기 및 설정을 제공합니다.

HoldingEventArgs

Holding 이벤트에 대한 이벤트 데이터를 포함합니다.

InputActivationListener

창, 보기 또는 기타 시각적 요소의 활성화 상태에 대한 변경 내용에 액세스하고 관찰하는 기능을 제공합니다.

InputActivationListenerActivationChangedEventArgs

InputActivationChanged 이벤트에 대한 이벤트 데이터를 포함합니다.

KeyboardDeliveryInterceptor

앱이 바로 가기 키, 액세스 키(또는 핫 키), 가속기 키 및 애플리케이션 키와 같은 키 조합을 포함하여 원시 키보드 입력의 시스템 처리를 재정의할 수 있도록 합니다.

원시 키보드 입력은 처리를 위해 가로채고, 표시하지 않으며, 앱(포그라운드에 있는 경우)으로 라우팅됩니다.

참고

Ctrl-Alt-Del, Windows-L 등의 SAS(Secure Attention Sequence) 키 조합은 계속 시스템에서 처리합니다.

ManipulationCompletedEventArgs

ManipulationCompleted 이벤트에 대한 이벤트 데이터를 포함합니다.

ManipulationInertiaStartingEventArgs

GestureRecognizer.ManipulationInertiaStartingEvent에 대한 이벤트 데이터를 포함합니다.

ManipulationStartedEventArgs

ManipulationStarted 이벤트에 대한 이벤트 데이터를 포함합니다.

ManipulationUpdatedEventArgs

ManipulationUpdated 이벤트에 대한 이벤트 데이터를 포함합니다.

MouseWheelParameters

마우스 디바이스의 단추 휠과 연결된 속성을 제공합니다.

PhysicalGestureRecognizer

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.
PointerPoint

단일 마우스, 펜/스타일러스 또는 터치 접점과 연결된 입력 포인터에 대한 기본 속성을 제공합니다.

PointerPointProperties

PointerPoint 개체에 대한 확장 속성을 제공합니다.

대부분의 경우 선택한 Windows 8 언어 프레임워크의 포인터 이벤트 처리기를 통해 포인터 정보를 가져오는 것이 좋습니다(JavaScript를 사용하는 Windows 앱, C++를 사용하는 UWP 앱, C#또는 Visual Basic을 사용하는 UWP 앱 또는 C++와 함께 DirectX를 사용하는 UWP 앱).

이벤트 인수가 앱에 필요한 포인터 세부 정보를 노출하지 않는 경우 getCurrentPointgetIntermediatePoints 메서드 또는 currentPointintermediatePoints 속성을 통해 이벤트 인수에서 확장 포인터 데이터에 액세스할 수 있습니다. 포인터 데이터의 컨텍스트를 지정할 수 있으므로 getCurrentPointgetIntermediatePoints 메서드를 사용하는 것이 좋습니다.

정적 PointerPoint 메서드인 GetCurrentPointGetIntermediatePoints는 항상 앱의 컨텍스트를 사용합니다.

PointerVisualizationSettings

포인터 입력에 대한 시각적 피드백 설정에 대한 액세스를 제공합니다.

중요

포인터 시각화는 데스크톱 디바이스 패밀리에서만 지원됩니다.

RadialController

휠 입력 장치 또는 Surface Dial과 같은 액세서리를 나타냅니다.

Surface Studio 펜이 있는 Surface Dial.

회전 작업(또는 제스처) 기반의 폼 팩터를 사용하는 Surface Dial은 기본 디바이스의 입력을 보완하는 보조 다중 모달 입력 디바이스로 고안되었습니다. 대부분의 경우에서 주요 손으로 작업을 수행하면서 나머지 손으로 이 디바이스를 조작합니다(예: 펜으로 수동 입력 수행). 즉, 정밀 포인터 입력(예: 터치, 펜 또는 마우스)용으로 고안되지 않았습니다.

또한 Surface Dial은 길게 누르기 작업 및 클릭 작업을 모두 지원합니다. 길게 누르기는 한 가지 기능을 제공합니다. 즉, 명령 메뉴가 표시됩니다. 메뉴가 활성화된 경우 메뉴를 통해 회전 및 클릭 입력이 처리됩니다. 그렇지 않은 경우 처리를 위해 앱에 입력이 전달됩니다.

RadialController 및 관련 API(항목의 끝 참조)를 사용하면 통합 명령 메뉴와 앱에서 지원하는 상호 작용 환경을 모두 사용자 지정할 수 있습니다.

RadialControllerButtonClickedEventArgs

ButtonClicked 이벤트에 대한 이벤트 데이터를 포함합니다(사용자 지정 RadialController 도구가 활성화된 동안에만 발생).

다음과 같은 경우 앱에서 이 이벤트를 수신하지 않습니다.

  • RadialController 메뉴가 활성화되어 있습니다.
  • 기본 제공 도구가 활성화되어 있습니다.

참고

시간 임계값을 초과하면 클릭이 길게 누르기 작업이 됩니다. 이 경우 휠 디바이스와 연결된 상황에 맞는 앱 명령의 통합 메뉴가 표시되고 후속 회전 및 클릭 이벤트가 메뉴에서 처리됩니다.

RadialControllerButtonHoldingEventArgs

ButtonHolding 이벤트에 대한 이벤트 데이터를 포함합니다(IsMenuSuppressedtrue인 경우에만 발생).

RadialControllerButtonPressedEventArgs

ButtonPressed 이벤트에 대한 이벤트 데이터를 포함합니다.

RadialControllerButtonReleasedEventArgs

ButtonReleased 이벤트에 대한 이벤트 데이터를 포함합니다.

RadialControllerConfiguration

RadialController 메뉴에 대한 구성 세부 정보를 제공합니다.

RadialControllerControlAcquiredEventArgs

RadialController 메뉴에서 사용자 지정 도구를 선택하거나 RadialController 개체와 연결된 앱을 포그라운드로 가져올 때(사용자 지정 RadialController 도구가 활성화된 동안에만 발생) ControlAcquired 이벤트에 대한 이벤트 데이터를 포함합니다.

RadialControllerMenu

RadialController 개체와 연결된 상황에 맞는 도구의 통합 메뉴를 나타냅니다.

참고

특정 앱 컨텍스트를 지원하기 위해 RadialController 메뉴에 추가된 도구는 해당 컨텍스트에만 표시됩니다. 다른 RadialController 인스턴스에는 표시되지 않습니다.

RadialControllerMenuItem

RadialController 메뉴의 단일 사용자 지정 도구를 나타냅니다.

RadialControllerRotationChangedEventArgs

RotationChanged 이벤트에 대한 이벤트 데이터를 포함합니다(사용자 지정 RadialController 도구가 활성화된 동안에만 발생).

다음과 같은 경우 앱에서 이 이벤트를 수신하지 않습니다.

  • RadialController 메뉴가 활성화되어 있습니다.
  • 기본 제공 도구가 활성화되어 있습니다.
RadialControllerScreenContact

사용자 지정 RadialController 도구가 활성 상태인 동안 디지타이저 표면에 배치할 때 휠 디바이스에 대한 연락처 세부 정보를 제공합니다.

애플리케이션 창을 기준으로 하는 DIP(디바이스 독립적 픽셀)입니다.

RadialControllerScreenContactContinuedEventArgs

ScreenContactContinued 이벤트에 대한 이벤트 데이터를 포함합니다(사용자 지정 RadialController 도구가 활성화된 동안에만 발생).

다음과 같은 경우 앱에서 이 이벤트를 수신하지 않습니다.

  • RadialController 메뉴가 활성화되어 있습니다.
  • 기본 제공 도구가 활성화되어 있습니다.
RadialControllerScreenContactEndedEventArgs

ScreenContactEnded 이벤트에 대한 이벤트 데이터를 포함합니다(사용자 지정 RadialController 도구가 활성 상태인 경우에만 발생).

다음과 같은 경우 앱에서 이 이벤트를 수신하지 않습니다.

  • RadialController 메뉴가 활성화되어 있습니다.
  • 기본 제공 도구가 활성화되어 있습니다.
RadialControllerScreenContactStartedEventArgs

ScreenContactStarted 이벤트에 대한 이벤트 데이터를 포함합니다(사용자 지정 RadialController 도구가 활성 상태인 경우에만 발생).

다음과 같은 경우 앱에서 이 이벤트를 수신하지 않습니다.

  • RadialController 메뉴가 활성화되어 있습니다.
  • 기본 제공 도구가 활성화되어 있습니다.
RightTappedEventArgs

RightTapped 이벤트에 대한 이벤트 데이터를 포함합니다.

SystemButtonEventController

하드웨어 시스템 단추(예: 함수 단추)에서 생성된 이벤트를 처리하는 기능을 사용하도록 설정합니다.

SystemFunctionButtonEventArgs

SystemFunctionButtonPressedSystemFunctionButtonReleased 이벤트에 대한 이벤트 데이터를 포함합니다.

SystemFunctionLockChangedEventArgs

SystemFunctionLockChanged 이벤트에 대한 이벤트 데이터를 포함합니다.

SystemFunctionLockIndicatorChangedEventArgs

SystemFunctionLockIndicatorChanged 이벤트에 대한 이벤트 데이터를 포함합니다.

TappedEventArgs

Tapped 이벤트에 대한 이벤트 데이터를 포함합니다.

TouchpadGesturesController

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.
TouchpadGlobalActionEventArgs

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.

구조체

CrossSlideThresholds

교차 슬라이딩 상호 작용에 대한 거리 임계값을 포함합니다.

ManipulationDelta

현재 조작에 대해 누적된 변환을 포함합니다.

ManipulationVelocities

현재 상호 작용에 대해 누적된 변환의 속도를 포함합니다.

참고

속도는 개체가 시간 단위 동안 지정된 방향으로 이동하는 거리입니다.

인터페이스

IPointerPointTransform

일반화된 변환 함수를 제공합니다.

열거형

CrossSlidingState

CrossSliding 이벤트의 가능한 상태를 지정합니다.

DraggingState

끌기 이벤트의 가능한 상태를 지정 합니다 .

EdgeGestureKind

에지 제스처 이벤트를 트리거한 사용자 입력 유형을 지정합니다.

GazeInputAccessStatus

사용자의 응시를 추적하기 위한 사용 권한 상태를 지정합니다.

GestureSettings

애플리케이션에서 지원하는 상호 작용을 지정합니다.

HoldingState

Holding 이벤트의 상태를 지정합니다.

InputActivationState

보기, 창 또는 기타 사용자 인터페이스 요소에 대해 가능한 모든 활성화 상태를 지정합니다.

PointerUpdateKind

애플리케이션에서 지원하는 포인터 업데이트 유형을 지정합니다.

RadialControllerMenuKnownIcon

RadialControllerMenu의 사용자 지정 RadialController 도구에 사용할 수 있는 시스템 아이콘 집합을 지정합니다.

RadialControllerSystemMenuItemKind

RadialControllerMenu에서 사용할 수 있는 기본 제공 RadialController 도구 집합을 지정합니다.

TouchpadGlobalAction

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.
TouchpadGlobalGestureKinds

Windows 입력 시스템에 대한 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 터치, 펜/스타일러스, 마우스 및 키보드 장치 입력.
  • 제스처 및 조작 검색, 인식 및 처리.
  • 관성 구성, 검색 및 처리.
  • 입력 포인터 관리.

추가 정보