UIElement.Tapped Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Tritt auf, wenn eine ansonsten unbehandelte Tap-Interaktion über dem Treffertestbereich dieses Elements auftritt.

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

TappedEventHandler

Hinweise

Touch-, Maus- und Stiftgeräte können eine Tap-Aktion erzeugen. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben.

Weitere Informationen zur Verwendung einer Tap-Interaktion in Ihrem App-Design finden Sie unter Touchinteraktionsentwurf. Die allgemeine Idee ist, dass eine Tap-Interaktion 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 auch ManipulationStarting ausgelöst werden. Selbst wenn ein Steuerelement bereits PointerPressed in der Steuerelementlogik verarbeitet oder Manipulationen verarbeitet, verhindert dies nicht, dass Tapped ausgelöst wird.

Ein Tapped-Ereignis ist potenziell das Ergebnis von mehr als einem Zeigerpunkt. Bei Gestenereignissen auf höherer Ebene wie Tapped haben Sie 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 können Sie GetPosition aufrufen, was einen Durchschnitt der Koordinaten für einen Tap von mehr als einem Zeigerpunkt angibt.

Getippt ist ein Routingereignis. Außerdem muss für ein Element IsTapEnabledtrue sein, um eine Tapped-Ereignisquelle zu sein (true ist die Standardeinstellung). Es ist möglich, Tapped für übergeordnete Elemente zu behandeln, auch wenn IsTapEnabled für das übergeordnete Element false ist, wenn das Ereignis aus einem untergeordneten Element der Ereignisquelle zu einem übergeordneten Element blasen wird, wobei IsTapEnabledfalse ist. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

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 ebenfalls auf die Treffertestsicht 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 Verarbeitet gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.

Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise auch über eine klassenbasierte Behandlung für das Tapped-Ereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Überschreibung für die Methode OnTapped. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Getippt und Holding schließen sich gegenseitig aus. Das Eingabesystem muss warten, bis der Zeigerpunkt freigegeben wird, um zu bestimmen, ob die Aktion getippt, gehalten oder eine andere Geste verwendet werden soll, damit Sie nicht in dem Moment getippt werden, in dem ein Benutzer den Bildschirm berührt. Wenn Sie wirklich sofortiges Feedback benötigen, können Sie stattdessen PointerPressed verwenden.

Wenn eine Benutzerinteraktion auch DoubleTapped auslöst, wird Tapped zuerst ausgelöst, um die erste Tippen darzustellen, aber beim zweiten Tippen wird kein zusätzliches Tippen ausgelöst. Wenn Sie eine andere Logik für Tapped und DoubleTapped wünschen, muss Ihr Tapped-Handler möglicherweise App-spezifische Variablen und einen Timer verwenden, um das Ausführen von Interaktionen zu vermeiden, die schließlich als DoubleTap-Aktion interpretiert werden.

Tippen für Maus- und Stift-/Eingabestift

Das Eingabesystem verarbeitet eine Aktion, bei der der Benutzer auf die linke Maustaste klickt, während er über das Element als getippte Aktion über das Element klickt. Das Ereignis wird erst ausgelöst, wenn die linke Maustaste losgelassen wird. Die Mauseingabe erzeugt standardmäßig keine Halteereignisse , unabhängig davon, wie lange eine Maustaste gedrückt gehalten wird oder welche Schaltfläche gehalten wird.

Bei Stiftgeräten führt das Berühren des Stiftgeräts zur Oberfläche und verbleibt an einem Ort zu einer Halteaktion .

Steuerelemente, die das Tapped-Ereignis nicht auslösen

Diese Steuerelemente lösen das Tapped-Ereignis nicht aus :

Gilt für:

Weitere Informationen