[일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 보증을 하지 않습니다.]
GestureRecognizer에서 반환된 디스플레이 독립적 픽셀이 아닌 디바이스에 상대적인 단위로 반환된 출력을 사용하여 포인터 입력에 대한 제스처 인식을 수행합니다. 이러한 출력 단위는 터치 패드 입력에 더 적합하므로 디스플레이가 아닌 터치 패드 자체를 기준으로 제스처를 인식할 수 있습니다.
포인터 입력이 인식기에 공급되면 활성화됩니다. 모든 연락처에 대해 출발 입력을 공급하거나 CompleteGesture()를 통해 강제로 완료하여 입력 상호 작용이 완료될 때까지 활성 상태로 유지됩니다.
모든 API는 GestureRecognizer의 해당 API와 동일하게 작동합니다. 유일한 차이점은 제스처 이벤트를 통해 노출되는 인식된 출력의 좌표 공간입니다.
Namespace: Windows. Ui. 입력
구성원
생성자
PhysicalGestureRecognizer();
PhysicalGestureRecognizer 런타임 클래스의 새 인스턴스를 반환합니다.
속성
IsActive
Boolean IsActive { get; }
입력 상호 작용이 여전히 처리되고 있는지 여부를 반환합니다.
GestureSettings
Windows.UI.Input.GestureSettings GestureSettings;
인식에 대해 구성된 제스처를 가져오거나 설정합니다. PhysicalGestureRecognizer는 다음과 같은 제스처 하위 집합을 지원합니다.
- 탭
- 보류
- ManipulationTranslate[Rails][X,Y]
- ManipulationRotate
- ManipulationScale
- ManipulationMultipleFingerPanning
터치 패드 입력은 더 이상 이러한 제스처를 수행할 수 없는 시나리오에서만 수신되므로 터치 패드 입력은 탭 또는 홀드로 인식되지 않습니다.
TapMinContactCount
UInt32 TapMinContactCount;
탭을 인식하는 데 필요한 최소 연락처 수를 가져오거나 설정합니다.
TapMaxContactCount
UInt32 TapMaxContactCount;
탭을 인식하는 데 필요한 최대 연락처 수를 가져오거나 설정합니다.
HoldMinContactCount
UInt32 HoldMinContactCount;
보류를 인식하는 데 필요한 최소 연락처 수를 가져오거나 설정합니다.
HoldMaxContactCount
UInt32 HoldMaxContactCount;
보류를 인식하는 데 필요한 최대 연락처 수를 가져오거나 설정합니다.
홀드라디우스
Single HoldRadius;
탭 또는 보류를 인식하기 위해 연락처가 원래 아래쪽 위치에서 유지해야 하는 반경을 가져오거나 설정합니다.
HoldStartDelay
Windows.Foundation.TimeSpan HoldStartDelay;
보류를 인식하기 전에 연락처가 중단되어야 하는 시간을 가져오거나 설정합니다. 대화 상대의 기간이 출발할 때 이 값보다 작고 HoldRadius보다 더 멀리 이동하지 않은 경우 탭이 인식됩니다.
TranslationMinContactCount
UInt32 TranslationMinContactCount;
번역을 인식하는 데 필요한 최소 연락처 수를 가져오거나 설정합니다.
TranslationMaxContactCount
UInt32 TranslationMaxContactCount;
번역을 인식하는 데 필요한 최대 연락처 수를 가져오거나 설정합니다.
메서드
ProcessDownEvent, ProcessMoveEvents, ProcessUpEvent
void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);
제스처 인식을 위해 지정된 포인터 입력을 PhysicalGestureRecognizer 에 공급합니다.
CompleteGesture
void CompleteGesture();
후속 입력이 새 제스처로 처리되도록 현재 상호 작용을 완료합니다. 제스처가 현재 진행 중인 경우 완료에 대한 이벤트가 트리거됩니다.
Events
ManipulationStarted
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;
PhysicalGestureRecognizer가 조작을 인식하기 시작할 때 트리거됩니다.
ManipulationUpdated
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;
PhysicalGestureRecognizer가 조작 중에 업데이트된 입력을 수신할 때 트리거됩니다.
조작 완료됨
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;
PhysicalGestureRecognizer가 조작 인식이 완료되면 트리거됩니다.
탭
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.TappedEventArgs> Tapped;
PhysicalGestureRecognizer가 탭을 인식할 때 트리거됩니다.
유지
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.HoldingEventArgs> Holding;
PhysicalGestureRecognizer가 보류 제스처를 인식할 때 트리거됩니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 11 |
| 네임스페이스 | Windows. Ui. 입력 |
| API 계약 | Windows. Foundation.UniversalApiContract(버전 19) |
| Invariant IdentityDetector (주체 불변 탐지기) | IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d |