다음을 통해 공유


InjectedInputPointerOptions 열거형

정의

InjectedInputMouseInfo, InjectedInputPenInfo 및 InjectedInputTouchInfo를 통해 포인터 입력을 시뮬레이션하는 데 사용되는 다양한 옵션 또는 한정자를 지정합니다.

이 열거형은 멤버 값의 비트 조합을 지원합니다.

public enum class InjectedInputPointerOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
enum class InjectedInputPointerOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public enum InjectedInputPointerOptions
var value = Windows.UI.Input.Preview.Injection.InjectedInputPointerOptions.none
Public Enum InjectedInputPointerOptions
상속
InjectedInputPointerOptions
특성

Windows 요구 사항

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

필드

Canceled 32768

시스템이 포인터에 대한 잘못된 입력을 수신하거나 활성 포인터가 있는 디바이스가 갑자기 출발할 때와 같이 포인터가 비정상적인 방식으로 출발했음을 나타냅니다. 입력을 수신하는 애플리케이션이 이 작업을 수행할 수 있는 위치에 있는 경우 상호 작용을 완료되지 않은 것으로 처리하고 포인터의 효과를 역방향으로 처리해야 합니다.

CaptureChanged 2097152

이 포인터가 다른 요소에 의해 캡처되고 원래 요소에서 캡처가 손실되었음을 나타냅니다.

Confidence 16384

포인터가 의도된 상호 작용인지 우발적 상호 작용을 나타내는지 여부에 대한 원본 디바이스의 제안을 나타내며, 이는 우발적인 상호 작용(예: 손바닥)이 입력을 트리거할 수 있는 터치 포인터와 특히 관련이 있습니다. 이 플래그의 존재는 원본 디바이스가 이 입력이 의도한 상호 작용의 일부라는 높은 신뢰도를 가지고 있음을 나타냅니다.

FirstButton 16

기본 작업을 나타냅니다.

터치 포인터는 디지타이저 표면과 접촉할 때 이 플래그를 설정합니다.

펜 포인터는 단추를 누르지 않고 디지타이저 표면과 접촉할 때 이 플래그를 설정합니다.

마우스 포인터는 왼쪽 마우스 단추가 아래쪽에 있을 때 이 플래그를 설정합니다.

InContact 4

포인터가 디지타이저 표면 또는 영역과 접촉하고 있음을 나타냅니다. 이 플래그가 설정되지 않은 경우 가리키기 포인터를 나타냅니다.

InRange 2

포인터가 계속 있음을 나타냅니다. 이 플래그가 설정되지 않은 경우 포인터가 검색 범위를 떠났다는 것을 나타냅니다.

New 1

새 포인터의 도착을 나타냅니다.

None 0

포인터 한정자가 없습니다. 기본값

PointerDown 65536

이 포인터가 디지타이저 표면과 접촉했음을 나타냅니다. 터치 포인터는 디지타이저 표면과 접촉할 때 이 플래그를 설정합니다.

펜 포인터는 디지타이저 표면과 접촉할 때 이 플래그를 설정합니다.

마우스 포인터에는 마우스 단추를 누를 때 이 플래그가 설정됩니다.

PointerUp 262144

이 포인터가 디지타이저 표면과의 접촉을 종료했음을 나타냅니다. 터치 포인터는 디지타이저 표면과의 접촉을 종료할 때 이 플래그를 설정합니다.

펜 포인터는 디지타이저 표면과의 접촉을 종료할 때 이 플래그를 설정합니다.

마우스 포인터에는 마우스 단추가 놓일 때 이 플래그가 설정됩니다.

Primary 8192

포인터가 기본이 아닌 포인터에서 사용할 수 있는 작업 이외의 작업을 수행할 수 있음을 나타냅니다. 예를 들어 기본 포인터가 창의 표면과 접촉하는 경우 창을 활성화할 수 있는 기회를 제공할 수 있습니다.

기본 포인터는 시스템의 모든 현재 사용자 상호 작용(마우스, 터치, 펜 등)에서 식별됩니다. 따라서 기본 포인터가 앱과 연결되지 않을 수 있습니다. 멀티 터치 조작의 첫 번째 접촉은 기본 포인터로 설정됩니다. 기본 포인터가 식별되면 새 연락처를 기본 포인터로 식별하기 전에 모든 연락처를 해제해야 합니다. 포인터 입력을 처리하지 않는 앱의 경우 기본 포인터의 이벤트만 마우스 이벤트로 승격됩니다.

SecondButton 32

보조 작업을 나타냅니다.

터치 포인터는 이 플래그를 사용하지 않습니다.

펜 포인터는 펜 배럴 단추를 눌렀을 때 디지타이저 표면과 접촉할 때 이 플래그를 설정합니다.

마우스 포인터는 오른쪽 마우스 단추가 아래쪽에 있을 때 이 플래그를 설정합니다.

Update 131072

포인터 상태 변경 내용을 포함하지 않는 간단한 업데이트를 나타냅니다.

예제

다음은 기본 입력 및 입력 주입을 보여주는 다운로드 가능한 샘플입니다.

설명

중요

이 네임스페이스의 API에는 inputInjectionBrokered 제한된 기능이 필요합니다.

입력 삽입을 사용하려면 Package.appxmanifest에 다음을 추가해야 합니다.

  • 받는 사람 <Package>
    • xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
    • IgnorableNamespaces="rescap"
  • 받는 사람 <Capabilities>
    • <rescap:Capability Name="inputInjectionBrokered" />

적용 대상

추가 정보