Share via

UIElement.ManipulationStarting Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt bei der ersten Erstellung des Manipulationsprozessors auf.

public:
 virtual event ManipulationStartingEventHandler ^ ManipulationStarting;
// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;
public event ManipulationStartingEventHandler ManipulationStarting;
function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;
Public Custom Event ManipulationStarting As ManipulationStartingEventHandler 
<uiElement ManipulationStarting="eventhandler"/>

Ereignistyp

ManipulationStartingEventHandler

Hinweise

Informationen zu benutzerdefinierten Steuerelementen und Interaktionsfunktionen finden Sie unter GestureRecognizer.

Ein Element muss einen anderen ManipulationMode-Wert als None oder System aufweisen, um eine Manipulationsereignisquelle zu sein. Der Standardwert von ist System, was die integrierte Steuerungslogik zum Verarbeiten von ManipulationMode Bearbeitungen ermöglicht, aber nicht zulässt, dass App-Code Manipulationsereignisse verarbeitet. Wenn Sie Bearbeitungen verarbeiten möchten, legen Sie auf Alloder auf bestimmte ManipulationModes-Werte festManipulationMode. Weitere Informationen finden Sie unter ManipulationMode.

ManipulationStarting löst grundsätzlich jedes Mal aus, wenn ein Zeiger mit einem Element interagiert, wobei das Element die Bearbeitung ermöglicht. Dies schließt Fälle ein, in denen die Manipulation als Geste interpretiert wird und sich die Zeiger nie bewegen, z. B. eine Geste mit Tippen oder Halten . Wenn die Zeiger verschoben werden, wird ManipulationStarted in der Regel danach ausgelöst.

ManipulationStarting ist ein Routingereignis. Wenn das Ereignis zu übergeordneten Elementen übergeblasen werden darf, weil es nicht behandelt wird, ist es möglich, das Ereignis für übergeordnete Elemente zu behandeln, auch wenn ManipulationMode oder System für das übergeordnete Element istNone. 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.

ManipulationStarting 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.

Gilt für:

Weitere Informationen