UIElement.PointerCanceled 이벤트

정의

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

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"/>

이벤트 유형

설명

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

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

중요

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

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

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

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

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

적용 대상

추가 정보