UIElement.PointerReleased 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 das Zeigergerät, das zuvor eine Drücken-Aktion initiiert hat, freigegeben wird, während innerhalb dieses Elements. Beachten Sie, dass das Ende einer Presseaktion nicht garantiert ist, dass ein PointerReleased Ereignis ausgelöst wird. Andere Ereignisse können stattdessen ausgelöst werden. Weitere Informationen finden Sie in den Anmerkungen.
public:
virtual event PointerEventHandler ^ PointerReleased;// Register
event_token PointerReleased(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerReleased(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerReleased;function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;Public Custom Event PointerReleased As PointerEventHandler <uiElement PointerReleased="eventhandler"/>
Ereignistyp
Hinweise
Touch-, Maus- und Zeichen-/Eingabestiftinteraktionen werden als Zeigereingaben in einer App empfangen, verarbeitet und verwaltet. Jede dieser Interaktionen kann ein PointerReleased Ereignis erzeugen. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben.
Andere Ereignisse statt PointerReleased können am Ende der Aktion ausgelöst werden, z. B. PointerCanceled oder PointerCaptureLost. Verlassen Sie sich nicht auf PointerPressed und PointerReleased Ereignisse, die immer in Paaren auftreten. Um ordnungsgemäß zu funktionieren, muss Ihre App auf alle Ereignisse lauschen und behandeln, die wahrscheinliche Rückschlüsse auf die Presseaktion darstellen. Einige der Gründe, warum Sie möglicherweise kein Vorkommen erhalten PointerReleased , sind:
- Unterschiede bei der Behandlung von Fingereingabeaktionen und Drücken-Aktionen durch bestimmte Hardware
- Programmgesteuerte Zeigererfassung von einem anderen Zeiger
- Benutzeraktionen, die die Beziehung des Anzeigebereichs ändern, z. B. Ändern der Auflösung oder Monitoreinstellungen
- Eingabeinteraktionen wie ein Eingabestift, der dieselbe Oberfläche berührt wie eine vorherige Toucheingabeaktion
Die Benutzeraktion, die ein Ereignis auslöst, kann zu einem PointerReleasedTapped Ereignis führen oder zu Bedingungen führen RightTapped , die je nach Gerät variieren. Weitere Informationen finden Sie unter "Getippt " und "RightTapped".
Die Mauseingabe wird einem einzelnen Zeiger zugeordnet, der beim ersten Erkennen der Mauseingabe zugewiesen wird. Durch Klicken auf eine Maustaste (links, Rad oder rechts) wird eine sekundäre Zuordnung zwischen dem Zeiger und dieser Schaltfläche durch das PointerPressed-Ereignis erstellt. Das PointerReleased Ereignis wird nur ausgelöst, wenn dieselbe Maustaste losgelassen wird (dem Zeiger kann keine andere Schaltfläche zugeordnet werden, bis dieses Ereignis abgeschlossen ist). Aufgrund dieser exklusiven Zuordnung werden andere Mausklicks über das PointerMoved-Ereignis weitergeleitet. Sie können den Zustand der Maustaste beim Behandeln dieses Ereignisses testen, wie im folgenden Beispiel gezeigt.
PointerReleased ist ein Routingereignis. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".
Bei Touchaktionen und auch bei interaktionsspezifischen oder Manipulationsereignissen, die Folgen einer Touchaktion sind, muss ein Element im Treffer-Test sichtbar sein, um als Ereignisquelle zu fungieren und das Ereignis auszulösen, das der Aktion zugeordnet ist. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich auch auf die Sichtbarkeit von Treffertests aus. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
PointerReleased unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als handled gekennzeichnet sind. Siehe "AddHandler".
Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das PointerReleased Eingabeereignis. Wenn ja, weist das Steuerelement wahrscheinlich eine Außerkraftsetzung für die Methode OnPointerReleased auf. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das Ereignis wird nicht für die PointerReleased Behandlung durch Benutzercodehandler für dieses Steuerelement ausgelöst. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie in der Übersicht über Ereignisse und Routingereignisse.
Steuerelemente können auch eine PointerUpThemeAnimation-Persönlichkeitsanimation aufweisen, die unabhängig vom Ereignis ausgeführt wird.