UIElement.DoubleTapped Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn eine ansonsten nicht behandelte DoubleTap-Interaktion über dem Treffertestbereich dieses Elements auftritt.

public:
 virtual event DoubleTappedEventHandler ^ DoubleTapped;
// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;
public event DoubleTappedEventHandler DoubleTapped;
function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;
Public Custom Event DoubleTapped As DoubleTappedEventHandler 
<uiElement DoubleTapped="eventhandler"/>

Ereignistyp

DoubleTappedEventHandler

Hinweise

Eine DoubleTap-Interaktion sind einfach zwei Tap-Interaktionen , die in kurzer Folge auftreten. Das genaue Timing, was das System als Doppeltippen interpretiert, kann vom Benutzer über die Systemeinstellungen angepasst werden.

Weitere Informationen zur Verwendung einer DoubleTap-Interaktion in Ihrem App-Design finden Sie unter Design der Touchinteraktion.

Wenn eine Benutzerinteraktion auch ausgelöst DoubleTappedwird, wird Taped zuerst ausgelöst, um den ersten Tippen darzustellen, aber beim zweiten Tippen wird kein zusätzlicher 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.

Ein DoubleTapped Ereignis stellt eine Geste dar, während ein PointerPressed-Ereignis ein Eingabeereignis auf niedrigerer Ebene ist. DoubleTapped Und PointerPressed Ereignisse können als Ergebnis einer einzelnen Benutzerinteraktion ausgelöst werden. Selbst wenn ein Steuerelement bereits Zeigerereignisse in der Steuerelementlogik verarbeitet oder Bearbeitungen verarbeitet, wird das Auslösen nicht verhindert DoubleTapped .

Ein DoubleTapped Ereignis ist potenziell das Ergebnis von mehr als einem Zeigerpunkt. Für Gestenereignisse auf höherer Ebene haben DoubleTapped 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 ein DoubleTap von mehr als einem Zeigerpunkt angibt.

DoubleTapped ist ein Routingereignis. Außerdem muss für ein Element IsDoubleTapEnabled vorhanden sein true , um eine DoubleTapped Ereignisquelle zu sein (true ist die Standardeinstellung). Es ist möglich, übergeordnete Elemente zu behandelnDoubleTapped, auch wenn falseIsDoubleTapEnabled sich auf dem übergeordneten Element befindet, wenn das Ereignis zu einem übergeordneten Element aus einem untergeordneten Element der Ereignisquelle führt, wobei IsDoubleTapEnabled istfalse. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

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.

DoubleTapped 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 über eine klassenbasierte Behandlung für das DoubleTapped Eingabeereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Überschreibung für die Methode OnDoubleTapped. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das DoubleTapped Ereignis wird nicht zur Behandlung von Benutzercodehandlern für dieses Steuerelement ausgelöst. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Gilt für:

Weitere Informationen