UIElement.PointerMoved 이벤트

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml
편집

포인터가 이 요소의 적중 테스트 영역 내에 남아 있는 동안 포인터가 움직일 때 발생합니다.

public:
 virtual event PointerEventHandler ^ PointerMoved;
// Register
event_token PointerMoved(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerMoved(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerMoved_revoker PointerMoved(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerMoved;
function onPointerMoved(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointermoved", onPointerMoved);
uIElement.removeEventListener("pointermoved", onPointerMoved);
- or -
uIElement.onpointermoved = onPointerMoved;
Public Custom Event PointerMoved As PointerEventHandler 
<uiElement PointerMoved="eventhandler"/>

이벤트 유형

PointerEventHandler

설명

터치, 마우스 및 펜/스타일러스 상호 작용은 UWP 앱에서 포인터 입력으로 수신, 처리 및 관리됩니다. 이러한 상호 작용은 이벤트를 생성할 PointerMoved 수 있습니다. 자세한 내용은 이 항목의 포인터 입력 처리 및 "마우스 및 스타일러스 입력에 대한 PointerMoved" 섹션을 참조하세요.

일부 UI 시나리오에서는 특히 사용자가 마우스를 사용하는 경우 이 이벤트가 많이 발생합니다. 이 처리기에 입력한 코드의 성능 프로필을 인식하고 논리를 실제로 실행해야 하는 횟수를 제한할 수 있는 고유한 플래그 또는 허용 오차를 사용하는 방법을 고려합니다.

이 이벤트는 라우트된 이벤트입니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

터치 동작의 경우와 터치 동작의 결과인 조작 관련 또는 조작 이벤트의 경우에도 이벤트 원본이 되거나 터치 동작과 연관된 이벤트를 실행하려면 요소의 적중 횟수 테스트가 보여야 합니다. UIElement.Visibility는표시되어야 합니다. 파생 형식의 다른 속성도 적중 테스트 표시 유형에 영향을 미칩니다. 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

이 이벤트는 이벤트에 대한 이벤트 데이터가 처리됨으로 표시되어 있더라도 호출될 경로에 이벤트 처리기를 연결하는 기능도 지원 합니다. AddHandler를 참조하세요.

포인터마우스 및 스타일러스 입력에 대해 이동됨

마우스 입력 디바이스에는 마우스 단추를 눌렀을 때에도 마우스가 요소의 경계를 넘어 이동할 때마다 표시되는 화면 커서가 있습니다. 펜 디바이스 입력에도 비슷한 동작이 제공됩니다. 여기서 입력 디바이스는 펜이 입력 장치 화면 바로 위에 마우스를 가져가고 있지만 펜을 건드리지 않는 것을 감지할 수 있습니다. 따라서 마우스 및 펜 입력은 터치 입력보다 이벤트를 더 자주 발생 PointerMoved 합니다. 자세한 내용은 마우스 조작을 참조하세요.

반면, 터치 포인트는 손가락이 표면에 닿는 경우에만 감지할 수 있습니다. 터치 포인트는 터치 포인트가 움직일 때 표면과 지속적으로 접촉하는 동안에만 생성 PointerMoved 됩니다. 생성되는 PointerMoved 이러한 종류의 터치 작업의 경우 작업이 조작 또는 제스처로 처리될 수도 있습니다. 자세한 내용은 포인터 입력 처리를 참조하세요.

마우스 입력은 마우스 입력이 처음 검색될 때 할당된 단일 포인터와 연결되며 마우스 시작 상호 작용은 모두 동일한 PointerId를 갖습니다. 마우스 단추(왼쪽, 휠 또는 오른쪽)를 클릭하면 PointerPressed 이벤트를 통해 포인터와 해당 단추 간의 보조 연결이 만들어집니다. PointerReleased 이벤트는 해당하는 동일한 마우스 단추를 해제한 경우에만 발생합니다(이 이벤트가 완료될 때까지는 다른 단추를 이 포인터와 연결할 수 없음). 이 단독 연결로 인해 다른 마우스 단추 클릭이 이벤트를 통해 PointerMoved 라우팅됩니다. 이 예제와 같이 이 이벤트를 처리할 때 마우스 단추 상태를 테스트할 수 있습니다.

게임과 같은 일부 애플리케이션은 특정 기능(예: 가상 트랙볼 또는 보기 카메라)에 대한 상대 마우스 움직임을 추적해야 하며 시스템 커서 또는 절대 화면 좌표를 사용하지 않습니다. 마우스 커서를 숨기고 절대 마우스 데이터를 무시하는 방법에 대한 자세한 내용은 상대 마우스 이동 및 CoreWindow를 참조하세요.

적용 대상

추가 정보