UIElement.PointerCanceled 이벤트

  • 참조

정의

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

연락처를 비정상적으로 만든 포인터가 연락처를 잃을 때 발생합니다.

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

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

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

이벤트 유형

PointerEventHandler

설명

PointerCanceled 발생이 발생하는 몇 가지 이유는 다음과 같습니다.

  • 디스플레이 영역의 관계를 변경하는 사용자 작업(예: 해상도 변경 또는 설정 모니터링)
  • 이전 터치 동작과 동일한 표면을 터치하는 스타일러스와 같은 입력 상호 작용
  • 사용자가 앱별이 아닌 로그오프 또는 유사한 중단을 기록합니다.
  • 동시 연락처 수가 디바이스에서 지원하는 수를 초과했습니다.

중요

PointerCanceled가 PointerReleased 대신 실행될 수 있습니다. PointerPressed 및 PointerReleased 이벤트가 항상 쌍으로 발생하는 것을 사용하지 마세요. 제대로 작동하려면 앱이 를 포함하는 PointerCanceledPress 작업에 대한 가능한 결론을 나타내는 모든 이벤트를 수신 대기하고 처리해야 합니다.

PointerCanceled 가 발생하면 해당 포인터에 의한 포인터 캡처가 해제됩니다. 포인터 캡처에 대한 자세한 내용은 CapturePointer를 참조하세요.

이벤트를 처리할 PointerCanceled 때 포인터 이벤트에 일반적으로 사용할 수 있는 이벤트 데이터 중 일부는 처리기를 통해 가져오는 PointerRoutedEventArgs 개체에서 의미가 없을 것으로 예상합니다. 예를 들어 포인터가 더 이상 존재하지 않으므로 포인터의 Microsoft.UI.Input.PointerPoint.Position 이 잘못되었습니다.

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

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

적용 대상

추가 정보