UIElement.RightTapped Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Tritt auf, wenn ein Eingabereiz mit der rechten Maustaste erfolgt, während sich der Zeiger über das Element befindet.

public:
 virtual event RightTappedEventHandler ^ RightTapped;
// Register
event_token RightTapped(RightTappedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::RightTapped_revoker RightTapped(auto_revoke_t, RightTappedEventHandler const& handler) const;
public event RightTappedEventHandler RightTapped;
function onRightTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("righttapped", onRightTapped);
uIElement.removeEventListener("righttapped", onRightTapped);
- or -
uIElement.onrighttapped = onRightTapped;
Public Custom Event RightTapped As RightTappedEventHandler 
<uielement RightTapped = "eventhandler" .../>

Ereignistyp

RightTappedEventHandler

Hinweise

RightTapped für eine Touchaktion ergibt sich aus der Verarbeitung einer Aktion, die für eine bestimmte Zeit an einem Ort verbleibt. Wenn es sich um eine Touchaktion handelt, wird immer ein Holding-Ereignis aus demselben Element vorangestellt, aber RightTapped wird erst ausgelöst, wenn der Berührungspunkt freigegeben wird. Wenn der Zeitpunkt, zu dem der Zeiger gedrückt wird, zu kurz ist und Tapped anstelle von Halten ausgelöst wird, oder wenn die Halteaktion mit HoldingState als Abgebrochen endet, wird RightTapped nicht ausgelöst.

RightTapped ist das Ereignis, das zum Anzeigen von Kontextmenüs behandelt werden soll. Weitere Informationen zur Verwendung einer Interaktion mit der rechten Maustaste in Ihrem App-Design finden Sie unter Touchinteraktionsdesign und UX-Richtlinien für benutzerdefinierte Benutzerinteraktionen.

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

Ein RightTapped-Ereignis ist potenziell das Ergebnis von mehr als einem Zeigerpunkt. Bei Gestenereignissen auf höherer Ebene wie RightTapped 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 ein RightTap von mehr als einem Zeigerpunkt angibt.

RightTapped ist ein Routingereignis. Außerdem muss für ein Element IsRightTapEnabledtrue sein, um eine RightTapped-Ereignisquelle zu sein (true ist die Standardeinstellung). Es ist möglich, RightTapped für übergeordnete Elemente zu behandeln, auch wenn IsRightTapEnabled für das übergeordnete Element false ist, wenn das Ereignis zu einem übergeordneten element aus einem untergeordneten Element der Ereignisquelle führt, wobei IsRightTapEnabledfalse ist. 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.

RightTapped 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 RightTapped-Ereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Überschreibung für die Methode OnRightTapped. Eine Rechtskippaktion kann dem Anzeigen eines Kontextmenüs oder eines sekundären Fensters zugeordnet sein. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie unter Übersicht über Ereignisse und Routingereignisse.

RightTapped für Maus- und Stift-/Eingabestift

Das Eingabesystem verarbeitet eine Aktion, bei der der Benutzer mit der rechten Maustaste über das Element als RightTapped-Aktion klickt. Das Ereignis wird erst ausgelöst, wenn die rechte 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.

Einige Stiftgeräte verfügen über mehrere Tasten, von denen eine auf die gleiche Weise wie die rechte Taste auf einem Mausgerät verwendet werden kann. Dies hängt vom Gerät und seinen Einstellungen ab, aber wenn ein Äquivalent mit der rechten Maustaste vom Stiftgerät aktiviert ist, kann das Eingabesystem auch RightTapped für diese Aktionen auslösen.

Windows 8-Verhaltensweise

Windows 8 hatte ein Problem mit den Daten für das RightTapped-Ereignis, bei dem die X - und Y-Werte für den Punkt, den Sie von RightTappedRoutedEventArgs.GetPosition erhalten würden, umgekehrt wurden (X war wirklich Y; Y war wirklich X). Dieses Problem wurde ab Windows 8.1 behoben. Wenn Sie jedoch eine Windows 8-App für Windows 8.1 neu ausrichten, hatten Sie möglicherweise Code, der dieses Problem umgehen kann, indem Sie X undY wieder austauschen. Wenn ja, entfernen Sie diesen Code beim erneuten Abrufen, da das Problem jetzt behoben ist.

Apps, die für Windows 8 kompiliert wurden, aber auf Windows 8.1 ausgeführt werden, verwenden weiterhin dieses Windows 8-Verhalten.

Außerdem beinhaltete Windows 8 keine Standardschlüsselbehandlung für UMSCHALT+F10, die dieses Ereignis auslöste und dann Kontextmenüs anzeigte. Umschalt+F10 ist in der Regel eine sekundäre Tastenkombination für den VK_APP virtuellen Schlüsselwert (die Eigenschaftentaste), und daher kann erwartet werden, dass UMSCHALT+F10 auch RightTapped auslöst. Dieses Problem wurde ab Windows 8.1 behoben. UMSCHALT+F10 löst jetzt RightTapped aus. Diese Änderung kann als Standardereignisbehandlung für einige Steuerelemente angezeigt werden, die über Standardkontextmenüs für Text verfügen, z. B . TextBox, oder beim Aufrufen benutzerdefinierter Menüs und Flyouts.

Apps, die für Windows 8 kompiliert wurden, aber auf Windows 8.1 ausgeführt werden, verwenden dieses Windows 8-Verhalten nicht, sondern das korrigierte Windows 8.1 Verhalten.

Gilt für:

Weitere Informationen