UIElement.ManipulationStarted 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 ein Eingabegerät mit einer Manipulation des UIElements beginnt.
// Register
event_token ManipulationStarted(ManipulationStartedEventHandler const& handler) const;
// Revoke with event_token
void ManipulationStarted(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationStarted_revoker ManipulationStarted(auto_revoke_t, ManipulationStartedEventHandler const& handler) const;public event ManipulationStartedEventHandler ManipulationStarted;function onManipulationStarted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarted", onManipulationStarted);
uIElement.removeEventListener("manipulationstarted", onManipulationStarted);
- or -
uIElement.onmanipulationstarted = onManipulationStarted;Public Custom Event ManipulationStarted As ManipulationStartedEventHandler <uiElement ManipulationStarted="eventhandler"/>
Ereignistyp
Hinweise
Informationen zu benutzerdefinierten Steuerelementen und Interaktionsfunktionen finden Sie unter "GestureRecognizer.ManipulationStarted".
ManipulationStarted stellt dar, dass die Manipulationserkennungslogik Zeigerbewegungen erkannt hat. In diesem Fall ist es das zweite Manipulationsereignis, das in einer typischen Sequenz ausgelöst wird, nach ManipulationStarting, aber vor ManipulationDelta oder anderen Ereignissen wie ManipulationInertiaStarting.
Ein Element muss einen anderen ManipulationMode-Wert als None oder System eine Manipulationsereignisquelle aufweisen. Der Standardwert ManipulationMode ist System, der die integrierte Steuerelementlogik zum Verarbeiten von Manipulationen ermöglicht, app-Code jedoch nicht das Behandeln von Manipulationsereignissen zulässt. Wenn Sie Manipulationen behandeln möchten, legen Sie diese ManipulationMode auf Alloder auf bestimmte ManipulationModes-Werte fest. Weitere Informationen finden Sie unter ManipulationMode.
ManipulationStarted ist ein Routingereignis. Wenn das Ereignis bis zu übergeordneten Elementen bubiert werden darf, da es nicht behandelt wird, ist es möglich, das Ereignis für übergeordnete Elemente zu behandeln, auch wenn ManipulationMode oder System das übergeordnete Element vorhanden istNone. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".
Bei Touchaktionen und auch bei interaktionsspezifischen oder Manipulationsereignissen, die Folgen einer Touchaktion sind, muss ein Element im Treffer-Test sichtbar sein, um als Ereignisquelle zu fungieren und das Ereignis auszulösen, das der Aktion zugeordnet ist. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich auch auf die Sichtbarkeit von Treffertests aus. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
ManipulationStarted unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als handled gekennzeichnet sind. Siehe "AddHandler".