UIElement.Tapped 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 eine andernfalls nicht behandelte Tippinteraktion über dem Treffertestbereich dieses Elements erfolgt.
public:
virtual event TappedEventHandler ^ Tapped;// Register
event_token Tapped(TappedEventHandler const& handler) const;
// Revoke with event_token
void Tapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Tapped_revoker Tapped(auto_revoke_t, TappedEventHandler const& handler) const;public event TappedEventHandler Tapped;function onTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("tapped", onTapped);
uIElement.removeEventListener("tapped", onTapped);
- or -
uIElement.ontapped = onTapped;Public Custom Event Tapped As TappedEventHandler <uiElement Tapped="eventhandler"/>
Ereignistyp
Hinweise
Touch-, Maus- und Stiftgeräte können alle eine Tippen-Aktion erzeugen. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben.
Weitere Informationen zur Verwendung einer Tippinteraktion in Ihrem App-Design finden Sie im Design für Fingereingabeinteraktionen. Die allgemeine Idee ist, dass eine Tippinteraktion für ein Element die primäre Aktion des Elements in Ihrer App aufruft.
Ein Tapped Ereignis stellt eine Geste dar, während ein PointerPressed-Ereignis ein Eingabeereignis auf niedrigerer Ebene ist.
Tapped und PointerPressed Ereignisse können als Ergebnis einer einzelnen Benutzerinteraktion ausgelöst werden. Wenn die Ereignisquelle über einen nicht standardmäßigen ManipulationMode verfügt, kann ManipulationStarting ebenfalls ausgelöst werden. Selbst wenn ein Steuerelement bereits in der Steuerelementlogik behandelt PointerPressed wird oder Manipulationen verarbeitet, wird dies nicht verhindert Tapped , dass ein Steuerelement ausgelöst wird.
Ein Tapped Ereignis ist potenziell das Ergebnis mehrerer Zeigerpunkte. Für die Gestikereignisse auf höherer Ebene, z Tapped . B. sie haben keinen direkten Zugriff mehr auf PointerPoint-Details wie einzelne PointerId-Werte oder einzelne Koordinaten. Sie haben Zugriff auf den Gerätetyp (PointerDeviceType) und für Koordinaten, die Sie GetPosition aufrufen können. Dadurch erhalten Sie einen Mittelwert der Koordinaten für einen Tipp von mehr als einem Zeigerpunkt.
Tapped ist ein Routingereignis. Außerdem muss ein Element IsTapEnabled eine Ereignisquelle sein trueTapped (true ist die Standardeinstellung). Es ist möglich, übergeordnete Elemente zu behandelnTapped, auch wenn falseIsTapEnabled sich das übergeordnete Element befindet, wenn das Ereignis einem übergeordneten Element aus einem untergeordneten Element der Ereignisquelle zugeordnet istfalse.IsTapEnabled Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".
Für Touchaktionen und auch für interaktionsspezifische oder Manipulationsereignisse, die Folgen einer Touchaktion sind, muss ein Element treffertestbar sein, um die Ereignisquelle zu sein. 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.
Tapped 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 können auch eine klassenbasierte Behandlung für das Tapped Ereignis haben. Wenn ja, weist das Steuerelement wahrscheinlich eine Außerkraftsetzung für die Methode OnTapped auf. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie in der Übersicht über Ereignisse und Routingereignisse.
Tapped und die Holding schließen sich gegenseitig aus. Das Eingabesystem muss warten, bis der Zeigerpunkt losgelassen wird, um zu bestimmen, ob die Aktion sein Tappedsoll, Holding oder eine andere Geste, sodass Sie nicht sofort darauf gelangen Tapped , dass ein Benutzer den Bildschirm berührt. Wenn Sie wirklich sofortiges Feedback benötigen, sollten Sie stattdessen PointerPressed verwenden.
Wenn eine Benutzerinteraktion auch DoubleTapped auslöst, wird zuerst ausgelöst, Tapped um den ersten Tipp darzustellen, aber der zweite Tipp löst keine zusätzliche TappedAushebung aus. Wenn Sie eine andere Logik für Tapped den Vergleich DoubleTappedverwenden möchten, muss der Tapped Handler möglicherweise appspezifische Variablen und einen Timer verwenden, um zu vermeiden, dass Interaktionen ausgeführt werden, die schließlich als DoubleTap-Aktion interpretiert werden.
Für Maus- und Zeichen-/Eingabestift getippt
Das Eingabesystem verarbeitet eine Aktion, bei der der Benutzer auf die linke Maustaste klickt, während das Element als Tapped Aktion angezeigt wird. Das Ereignis wird erst ausgelöst, wenn die linke Maustaste losgelassen wird. Die Mauseingabe erzeugt standardmäßig keine Holdingereignisse , unabhängig davon, wie lange eine Maustaste gedrückt gehalten wird oder welche Schaltfläche gehalten wird.
Bei Stiftgeräten erzeugt das Berühren des Stiftgeräts auf die Oberfläche und verbleibt an einem Ort eine Halteaktion .
Steuerelemente, die das Tapped-Ereignis nicht auslösen
Diese Steuerelemente lösen das Tapped Ereignis nicht aus: