UIElement.PointerExited Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Tritt auf, wenn ein Zeiger den Treffertestbereich dieses Elements verlässt.

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

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

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

Ereignistyp

PointerEventHandler

Hinweise

Das PointerExited-Ereignis wird als Reaktion auf einen Zeiger ausgelöst, der sich zunächst im begrenzungsbasierten Bereich des Elements befand und diesen begrenzungsenden Bereich verlässt. Touch-, Maus- und Stift-/Eingabestiftinteraktionen werden als Zeigereingaben in der UWP-App empfangen, verarbeitet und verwaltet. Jedes dieser Geräte und ihre Interaktionen können ein PointerExited-Ereignis erzeugen. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben und den anderen Anmerkungen in diesem Thema.

Verwenden Sie einen auf PointerEventHandler basierenden Handler, um dieses Ereignis zu behandeln.

Bei Toucheingabeaktionen und interaktionsspezifischen Ereignissen oder Manipulationsereignissen, die aus einer Toucheingabeaktion resultieren, muss ein Element bei Treffertests sichtbar sein, damit es der Ereignisquelle entsprechen und das der Aktion zugeordnete Ereignis auslösen kann. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich ebenfalls auf die Treffertestsicht aus. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

PointerExited 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.

Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das PointerExited-Eingabeereignis. Wenn ja, hat das Steuerelement wahrscheinlich eine Überschreibung für die Methode OnPointerExited. In der Regel wird das Ereignis nicht vom Klassenhandler behandelt, sodass das PointerExited-Ereignis weiterhin von Ihrem Benutzercode für das Steuerelement in Ihrer Benutzeroberfläche behandelt werden kann. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Wenn ein anderes Element den Zeiger erfasst hat, wird PointerExited nicht ausgelöst, auch wenn der erfasste Zeiger die Grenzen eines Elements verlässt. Weitere Informationen zur Zeigererfassung finden Sie unter CapturePointer - oder Mausinteraktionen.

PointerExited für Maus- und Stift-/Eingabestift

Ein Mauseingabegerät verfügt über einen Bildschirmcursor, der immer sichtbar ist, wenn sich die Maus bewegt, auch wenn gerade keine Maustaste gedrückt wird. Ein ähnliches Verhalten ist für die Eingabe eines Stiftgeräts verfügbar, bei dem die Eingabegeräte erkennen können, dass der Eingabestift mit dem Mauszeiger direkt über die Eingabegeräteoberfläche (IsInRange) zeigt, ihn aber nicht berührt. Maus- und Stiftgeräteeingaben lösen daher PointerExited-Ereignisse in etwas anderen Fällen aus als Touchereignisse. Weitere Informationen finden Sie unter Mausinteraktionen. Ein PointerExited-Ereignis wird ausgelöst, nachdem das letzte PointerMoved-Ereignis für das Element ausgelöst wird.

PointerExited für Toucheingabe

Ein Berührungspunkt kann nur erkannt werden, wenn ein Finger die Oberfläche berührt. Wenn eine Touchaktion zu einem PointerReleased-Ereignis führt, wird diesem Ereignis sofort ein PointerExited-Ereignis gefolgt, wobei alle Ereignisdaten dieselben Informationen für die beiden Ereignisse sind (gleiche Zeiger-ID, gleiche Position usw.). Mit anderen Worten, der Zeiger wird so betrachtet, dass er das Element in dem Moment eingibt und die Position angibt, an der das Element von einem Touchpunkt berührt wird.

Alternativ generiert ein Touchpunkt PointerExited, wenn dieser Zeiger während der Bewegung konstant mit der Oberfläche in Kontakt bleibt, sich zunächst über dem Element befand und dann die Treffertestgrenzen eines Elements beendet. Für diese Art von Touchaktionen ist es auch möglich, dass die Aktion als Manipulation oder als Geste und nicht als Zeigerereignis verarbeitet werden kann. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben.

Routingereignisverhalten für PointerExited

PointerExited ist ein Routingereignis. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse. Sie können mehrere PointerExited-Ereignisse für Elemente in einer XAML-Benutzeroberfläche definieren, einschließlich für Elemente, die sich in einer beziehung zwischen übergeordneten und untergeordneten Elementen befinden. In einer typischen UI-Komposition befinden sich die untergeordneten Elemente innerhalb der Grenzen eines übergeordneten Elements, sodass das PointerExited-Ereignis zuerst für das untergeordnete Element auftritt, wenn sich der Zeiger aus dem untergeordneten Element bewegt, und dann für das übergeordnete Element, wenn sich der Zeiger vollständig aus diesem übergeordneten Element entfernt. Das PointerExited-Ereignis wird normalerweise nicht an das übergeordnete Element weitergeleitet, wenn es vom untergeordneten Element ausgelöst wird, da es für das Eingabesystem verwirrend wäre, das PointerExited-Ereignisereignis auch an das übergeordnete Element weiterzuleiten. In der Regel möchten Sie nicht, dass PointerExited-Ereignisse trotzdem weitergeleitet werden, Sie möchten sie nur vom Absender verarbeiten. Sie können das Ereignisrouting explizit verhindern, indem Sie Handled in Ihrem Handler auf true festlegen.

In seltenen Fällen ist es möglich, eine PointerExited-Ereignisblase für das übergeordnete Element anzuzeigen. Wenn Sie beispielsweise einen RenderTransform-Wert verwendet haben, um ein untergeordnetes Element außerhalb der Grenzen des übergeordneten Elements zu offseten, wird das Ereignis beim Beenden des untergeordneten Elements an das übergeordnete Element übergeben und gibt die Ereignisinformationen an, die davon berichtet werden, wie das untergeordnete Element das Ereignis ausgelöst hat.

ZeigerVisualstatus für Steuerelemente anzeigen

Steuerelemente mit Steuerelementvorlagen können visuelle Zustände anwenden, die nur aktiv sind, wenn sich ein Zeiger über die Grenzen des Steuerelements befindet. Sie müssen pointerEntered oder PointerExited nicht immer verarbeiten, um dieses Verhalten abzurufen oder zu ändern. Möglicherweise müssen Sie das Steuerelement neu erstellen. Wenn Sie von einem vorhandenen Steuerelement ableiten, das bereits über die Eingabebehandlung auf niedriger Ebene verfügt, die visuelle Zustände aufruft, sollten Sie einen visuellen Zustand mit dem Namen "PointerOver" in der VisualStateGroup "CommonStates" bereitstellen, und die integrierte Steuerelementlogik lädt diesen visuellen Zustand, wenn sich ein Zeiger über das Steuerelement befindet. Für Steuerelemente, die aufgerufen oder ausgewählt werden können, z. B. Button oder ListViewItem, ist häufig ein visueller Zustand für zeigerüber vorhanden. Wenn Sie von einer Basisklasse wie Control ableiten, die nicht über eine integrierte Eingabeereignisbehandlung verfügt, die visuelle Zustände aufruft, müssen Sie möglicherweise OnPointerEntered und OnPointerExited überschreiben, um dieses Verhalten zu erhalten. Verwenden Sie OnPointerExited , um GoToState aufzurufen, um einen anderen Zustand als den Zustand "PointerOver" zu laden, z. B. "Normal". Weitere Informationen finden Sie unter Storyboardanimationen für visuelle Zustände.

Windows 8-Verhaltensweise

Für Windows 8 wird das PointerEntered-Ereignis im Allgemeinen nicht ausgelöst, wenn sich der Bildschirmcursor (oder der Eingabestift oder der Touchpoint) nicht tatsächlich bewegt hat. Beispielsweise wird PointerEntered nicht ausgelöst, wenn die Maus und ihr Bildschirmcursor nicht stehen bleiben und ein Objekt mit einem PointerEntered-Handler seine Position übersetzt oder anderweitig so angepasst wird, dass es sich unter dem Bildschirmcursor bewegt. Oder PointerEntered wird nicht ausgelöst, wenn ein Element wie ein Popup- oder Flyout verschwindet und sich der Zeiger jetzt auf ein neues Element befindet (der Zeiger wurde jedoch noch nicht verschoben). Im Zusammenhang damit ist das PointerExited-Verhalten. Wenn ein Popup beispielsweise programmgesteuert geschlossen wird, wird PointerExited nicht ausgelöst, wenn sich der Zeiger nicht als Ursache für das Schließen bewegt hat. Sie erhalten weiterhin ein PointerEntered-Ereignis , wenn sich der Zeiger über das neu offenbarte Element bewegt. Ob dies geschieht, liegt jedoch beim Benutzer, und es geschieht zum Zeitpunkt der Bewegung, nicht im Moment der Kündigung. Kurz gesagt, der Versuch, das letzte Element zu verwenden, das PointerEntered für die Bestimmung des Zeigerzustands auf der App-Benutzeroberfläche ausgelöst hat, ist in Windows 8 nicht umfassend, und es gibt viele Szenarien, in denen PointerEntered und PointerExited nicht paaren. Dies wirkt sich auch auf die visuellen Zustände für Steuerelemente aus, die PointerEntered und PointerExited als Trigger verwenden.

Ab Windows 8.1 wird PointerExited für jeden Fall ausgelöst, in dem der Zeiger einmal ein PointerEntered-Ereignis ausgelöst hatte. Eine Änderung des Ui-Zustands erfolgt jedoch, wenn sich der Zeiger nicht mehr innerhalb dieses Elements befindet. Dies schließt Fälle ein, in denen das gesamte Element verschwindet. Und wenn sich der Zeiger jetzt auf ein anderes Element befindet, weil ein vorheriges Element verschwunden ist, löst dieses Element PointerEntered aus, auch wenn sich der Zeiger nie bewegt. Elemente, die ihre Sichtbarkeit programmgesteuert auf Reduziert festlegen, ist eine Möglichkeit, dass Elemente von der Benutzeroberfläche verschwinden können, und das Windows 8.1 Verhalten berücksichtigt dies und löst PointerExited für das Collapsed-Element und PointerEntered für das neu offenbarte Element aus.

Wenn Sie Ihren App-Code von Windows 8 zu Windows 8.1 migrieren, sollten Sie diese Verhaltensänderung berücksichtigen, da dies dazu führt, dass PointerExited und PointerEntered in Fällen ausgelöst werden, in denen sie zuvor nicht ausgelöst hätten.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Gilt für:

Weitere Informationen