UIElement.Tapped Ereignis

  • Referenz

Definition

Namespace:
Microsoft.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 in der Steuerelementlogik verarbeitet PointerPressed wird oder Manipulationen verarbeitet, verhindert Tapped dies das Auslösen nicht.

Ein Tapped Ereignis ist potenziell das Ergebnis von mehr als einem Zeigerpunkt. Bei Gestenereignissen höherer Ebene, z Tapped . B. 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.

Tapped ist ein Routingereignis. Außerdem muss ein Element IsTapEnabled aufweisen true , um eine Tapped Ereignisquelle zu sein (true ist die Standardeinstellung). Es ist möglich, übergeordnete Elemente zu behandelnTapped, auch wenn falseIsTapEnabled sich auf dem übergeordneten Element befindet, wenn das Ereignis zu einem übergeordneten Element aus einem untergeordneten Element der Ereignisquelle führt, wobei IsTapEnabled istfalse. 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 Behandelt 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.

Tapped und Holding schließen sich gegenseitig aus. Das Eingabesystem muss warten, bis der Zeigerpunkt freigegeben wird, um zu bestimmen, ob die Aktion oder eine andere Geste sein TappedHolding soll, damit Sie nicht in dem Moment erhaltenTapped, 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 zuerst ausgelöst, Tapped um die erste Tippen darzustellen, aber beim zweiten Tippen wird kein zusätzliches Tappedausgelöst. Wenn Sie eine andere Logik für Tapped im Vergleich DoubleTappedmöchten, muss Ihr Tapped Handler möglicherweise appspezifische 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 mit der linken Maustaste über das Element als Tapped Aktion 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