UIElement.TryStartDirectManipulation(Pointer) 메서드

정의

네임스페이스:

Microsoft.UI.Xaml

현재 UIElement가 포함된 ScrollViewer 부모에서 직접 조작 처리(시스템 정의 이동/확대/축소)를 다시 시작합니다.

public:
 static bool TryStartDirectManipulation(Pointer ^ value);

 static bool TryStartDirectManipulation(Pointer const& value);

public static bool TryStartDirectManipulation(Pointer value);

function tryStartDirectManipulation(value)

Public Shared Function TryStartDirectManipulation (value As Pointer) As Boolean

매개 변수

value

Pointer

조작을 시작한 활성 터치 지점입니다.

반환

Boolean

bool

trueScrollViewer 부모가 있고 값을 설정하면 이동/확대/축소 작업이 다시 발생합니다. false 메서드를 호출하면 아무 작업도 수행되지 않습니다.

설명

기본적으로 ScrollViewer 요소의 터치 입력 상호 작용은 UI 스레드에서 직접 조작 엔진에 의해 처리됩니다. 직접 조작 처리가 시작된 후에는 앱이 연결된 포인터 이벤트를 직접 처리할 수 없습니다. 상호 작용 시작 시 CancelDirectManipulations 를 ScrollViewer 호출하고 UI 스레드에서 포인터 이벤트를 처리할 수 있으므로 에서 사용자 지정 입력 처리를 수행할 수 있습니다 ScrollViewer.

ScrollViewer 상호 작용을 시작할 때 직접 조작 처리를 취소하는 경우 를 호출 TryStartDirectManipulation 하여 직접 조작이 입력 스트림을 처리하도록 다시 시작할 수 있습니다. 이렇게 하면 먼저 사용자 지정 입력 처리를 수행하고 직접 조작 처리를 다시 시작하면 스크롤 및 확대/축소와 같은 터치 조작에 대한 앱의 응답성이 높아질 수 있습니다.

활성 터치 연락처만 직접 조작에 전달할 수 있습니다. 비활성 또는 비터치 연락처를 사용하면 예외가 throw됩니다.

직접 조작에 전달할 터치 연락처를 지정하면 프레임워크가 부모 체인을 걷고 각 ScrollViewer의 직접 조작 뷰포트에서 연락처를 순서대로 설정하여 Walk가 ManipulationModes.System을 포함하는 ManipulationMode가 없는 요소(원래 대상 요소 포함)에 도달할 때까지 발생합니다. 지정된 터치 접촉은 한 번에 하나의 시각적 개체 체인과만 연결할 수 있습니다. 동일한 연락처에서 두 번 이상 호출 TryStartDirectManipulation 하면 이전 체인이 해제됩니다.

추가 정보

• CancelDirectManipulations()
• ManipulationStarted
• ManipulationModes
• 제스처, 조작 및 상호 작용
• 직접 조작