UIElement.DoubleTapped 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 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
Hinweise
Eine DoubleTap-Interaktion besteht einfach aus zwei Tap-Interaktionen , die in kurzer Folge auftreten. Das genaue Timing, was das System als Doppeltippen interpretiert, wird vom Benutzer über die Systemeinstellungen angepasst.
Weitere Informationen zur Verwendung einer DoubleTap-Interaktion in Ihrem App-Design finden Sie unter Touchinteraktionsdesign.
Wenn eine Benutzerinteraktion auch DoubleTapped auslöst, wird Tapped zuerst ausgelöst, um den ersten Tippen darzustellen, aber beim zweiten Tippen wird kein zusätzliches Getippt ausgelöst. Wenn Sie eine andere Logik für Tapped und DoubleTapped wünschen, 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, verhindert dies nicht, dass DoubleTapped ausgelöst wird.
Ein DoubleTapped-Ereignis ist möglicherweise das Ergebnis von mehr als einem Zeigerpunkt. Bei Gestenereignissen auf höherer Ebene wie DoubleTapped haben Sie keinen sofortigen 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, wodurch ein Mittelwert der Koordinaten für ein DoubleTap von mehr als einem Zeigerpunkt angegeben wird.
DoubleTapped ist ein Routingereignis. Außerdem muss für ein Element IsDoubleTapEnabledtrue sein, um eine DoubleTapped-Ereignisquelle zu sein (true ist die Standardeinstellung). Es ist möglich, DoubleTapped für übergeordnete Elemente zu behandeln, auch wenn IsDoubleTapEnabled für das übergeordnete Element false ist, wenn das Ereignis aus einem untergeordneten Ereignisquellenelement in eine Blase eingeblasen wird, wobei IsDoubleTapEnabledfalse ist. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
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 Sichtbarkeit von Treffertests 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 Verarbeitet 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 dies der Grund ist, verfügt das Steuerelement wahrscheinlich über eine Außerkraftsetzung für die OnDoubleTapped-Methode. 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 von Ereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.