Freigeben über

UIElement.PointerCanceled Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn ein Zeiger, der den Kontakt hergestellt hat, den Kontakt anormal verliert.

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

Ereignistyp

PointerEventHandler

Hinweise

Einige der Gründe, warum Sie ein PointerCanceled-Vorkommen erhalten können, sind:

  • Benutzeraktionen, die die Beziehung des Anzeigebereichs ändern, z. B. Ändern von Auflösungs- oder Monitoreinstellungen
  • Eingabeinteraktionen wie ein Eingabestift, der dieselbe Oberfläche berührt wie eine vorherige Touchaktion
  • Der Benutzer meldet sich ab oder ähnliche Unterbrechungen, die nicht appspezifisch sind
  • Die Anzahl gleichzeitiger Kontakte überschreitet die vom Gerät unterstützte Anzahl.

Wichtig

PointerCanceled kann anstelle von PointerReleased ausgelöst werden. Verlassen Sie sich nicht auf PointerPressed und PointerReleased Ereignisse, die immer paarweise auftreten. Um ordnungsgemäß zu funktionieren, muss Ihre App alle Ereignisse abhören und behandeln, die die möglichen Schlussfolgerungen für eine Press-Aktion darstellen, und dies enthält PointerCanceled.

Wenn PointerCanceled ausgelöst wird, werden alle Zeigererfassungen durch diesen Zeiger freigegeben. Weitere Informationen zur Zeigererfassung finden Sie unter CapturePointer.

Gehen Sie beim Behandeln eines PointerCanceled Ereignisses davon aus, dass einige der Ereignisdaten, die normalerweise für ein Zeigerereignis verfügbar sind, im PointerRoutedEventArgs-Objekt , das Sie über den Handler erhalten, nicht aussagekräftig sind. Beispielsweise ist die Microsoft.UI.Input.PointerPoint.Position des Zeigers ungültig, da der Zeiger nicht mehr vorhanden ist.

PointerCanceled ist ein Routingereignis. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

PointerCanceled unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als Behandelt gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.

Gilt für:

Weitere Informationen