UIElement.PointerCanceled Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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, einschließlich 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 sinnvoll sind. Beispielsweise ist die Position des Zeigers ungültig, da der Zeiger nicht mehr vorhanden ist.
PointerCanceled ist ein routingfähiges Ereignis. 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 Verarbeitet gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.