UIElement.PointerMoved 이벤트

  • 참조

정의

네임스페이스:
Windows.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를 생성합니다. PointerMoved를 생성하는 이러한 종류의 터치 작업의 경우 작업이 조작 또는 제스처로 처리될 수도 있습니다. 자세한 내용은 포인터 입력 처리를 참조하세요.

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

private void Target_PointerMoved(object sender, PointerRoutedEventArgs e)
{
    Windows.UI.Xaml.Input.Pointer ptr = e.Pointer;

    // Multiple, simultaneous mouse button inputs are processed here.
    // Mouse input is associated with a single pointer assigned when 
    // mouse input is first detected. 
    // Clicking additional mouse buttons (left, wheel, or right) during 
    // the interaction creates secondary associations between those buttons 
    // and the pointer through the pointer pressed event. 
    // The pointer released event is fired only when the last mouse button 
    // associated with the interaction (not necessarily the initial button) 
    // is released. 
    // Because of this exclusive association, other mouse button clicks are 
    // routed through the pointer move event.          
    if (ptr.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Mouse)
    {
        // To get mouse state, we need extended pointer details.
        // We get the pointer info through the getCurrentPoint method
        // of the event argument. 
        Windows.UI.Input.PointerPoint ptrPt = e.GetCurrentPoint(Target);
        if (ptrPt.Properties.IsLeftButtonPressed)
        {
            eventLog.Text += "\nLeft button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsMiddleButtonPressed)
        {
            eventLog.Text += "\nWheel button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsRightButtonPressed)
        {
            eventLog.Text += "\nRight button: " + ptrPt.PointerId;
        }
    }

    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    // Display pointer details.
    updateInfoPop(e);
}

private void Target_PointerMoved(object sender, PointerRoutedEventArgs e)
{
    Windows.UI.Xaml.Input.Pointer ptr = e.Pointer;

    // Multiple, simultaneous mouse button inputs are processed here.
    // Mouse input is associated with a single pointer assigned when 
    // mouse input is first detected. 
    // Clicking additional mouse buttons (left, wheel, or right) during 
    // the interaction creates secondary associations between those buttons 
    // and the pointer through the pointer pressed event. 
    // The pointer released event is fired only when the last mouse button 
    // associated with the interaction (not necessarily the initial button) 
    // is released. 
    // Because of this exclusive association, other mouse button clicks are 
    // routed through the pointer move event.          
    if (ptr.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Mouse)
    {
        // To get mouse state, we need extended pointer details.
        // We get the pointer info through the getCurrentPoint method
        // of the event argument. 
        Windows.UI.Input.PointerPoint ptrPt = e.GetCurrentPoint(Target);
        if (ptrPt.Properties.IsLeftButtonPressed)
        {
            eventLog.Text += "\nLeft button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsMiddleButtonPressed)
        {
            eventLog.Text += "\nWheel button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsRightButtonPressed)
        {
            eventLog.Text += "\nRight button: " + ptrPt.PointerId;
        }
    }

    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    // Display pointer details.
    updateInfoPop(e);
}

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

적용 대상

추가 정보