UIElement.ManipulationStarting Ereignis

  • Referenz

Definition

Namespace:
Windows.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 über einen anderen ManipulationMode-Wert als None oder System verfügen, um eine Manipulationsereignisquelle zu sein. Der Standardwert von ManipulationMode ist System, der die integrierte Steuerungslogik zum Verarbeiten von Manipulationen ermöglicht, aber nicht zulässt, dass App-Code Manipulationsereignisse verarbeitet. Wenn Sie Bearbeitungen verarbeiten möchten, legen Sie ManipulationMode auf Alle oder auf bestimmte ManipulationModes-Werte fest. Weitere Informationen finden Sie unter ManipulationMode.

ManipulationStarting löst grundsätzlich jedes Mal aus, wenn ein Zeiger mit einem Element interagiert, bei dem 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 im übergeordneten Element keine oder System für das übergeordnete Element 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.

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

Windows 8-Verhaltensweise

Windows 8 hatte ein Problem beim Auslösen dieses Ereignisses, wenn mehrere Gesten in kurzer Zeit aufgetreten sind. Beispielsweise kann Windows 8 manipulationStarting nur für die erste Und nicht für die zweite Geste auslösen. Das Problem wurde ab Windows 8.1 behoben. Mehrere Startgesten, die vom Eingabesystem verarbeitet werden, lösen jeweils ein eindeutiges ManipulationStarting-Ereignis aus.

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

Gilt für:

Weitere Informationen