UIElement.ManipulationMode Eigenschaft

  • Referenz

Definition

Namespace:
Windows.UI.Xaml
Bearbeiten

Ruft den ManipulationModes-Wert ab, der für das UiElement-Verhalten und die Interaktion mit Gesten verwendet wird, oder legt den Wert fest. Das Festlegen dieses Werts ermöglicht die Behandlung der Bearbeitungsereignisse dieses Elements im App-Code.

public:
 property ManipulationModes ManipulationMode { ManipulationModes get(); void set(ManipulationModes value); };
ManipulationModes ManipulationMode();

void ManipulationMode(ManipulationModes value);
public ManipulationModes ManipulationMode { get; set; }
var manipulationModes = uIElement.manipulationMode;
uIElement.manipulationMode = manipulationModes;
Public Property ManipulationMode As ManipulationModes
<uiElement ManipulationMode="All"/>
-or-
<uiElement ManipulationMode="None"/>
-or-
<uiElement ManipulationMode="singleManipulationModesMemberName"/>
-or-
<uiElement ManipulationMode="relatedManipulationModesNames"/>

Eigenschaftswert

ManipulationModes

Ein -Wert oder -Wert der -Enumeration. Der Standardwert ist in der Regel System, aber dies kann je nach bestimmten Steuerelementen und Elementen variieren. Siehe Hinweise.

Hinweise

Sie müssen manipulationMode auf einen anderen Wert als System oder None festlegen, wenn Sie Manipulationsereignisse wie ManipulationStarted von UI-Elementen in Ihrem App-Code behandeln möchten. Weitere Informationen zu Bearbeitungen finden Sie unter Verarbeiten von Zeigereingaben.

Der typische Standardwert von ManipulationMode ist System und nicht None. Wenn der Wert System ist, können Bearbeitungen, die aus dem Element stammen, von der Windows-Runtime-Infrastruktur verarbeitet werden, die auf der Api für direkte Manipulation basiert. Beispielsweise verarbeitet ScrollViewer Benutzerbearbeitungen in seiner Steuerelementlogik und verarbeitet sie als Bildlaufaktionen für das Steuerelement. Der Wert System ermöglicht auch Persönlichkeitsanimationen, die auf Manipulationsereignisse reagieren.

Schieberegler und ToggleSwitch verfügen über Standardvorlagen, die den ManipulationMode-Wert auf None festlegen, sodass None der Standardwert ist, der zur Entwurfszeit angezeigt wird.

Sie können mehr als einen der flagweisen ManipulationModes-Werte als Wert der ManipulationMode-Eigenschaft angeben. Dies ist in XAML mithilfe der Kommasyntax möglich, die im Abschnitt "XAML-Werte" gezeigt wird. Beispielsweise können Sie TranslateX, TranslateY, Rotate und Scale oder eine beliebige Kombination daraus kombinieren. Es sind jedoch nicht alle Kombinationen gültig. Die Gültigkeit wird nur erzwungen, wenn ManipulationModes von einem bestimmten Steuerelement verwendet wird, sodass Probleme beim Festlegen einer ungültigen Kombination von ManipulationModes möglicherweise erst auftreten, wenn die Werte zur Laufzeit angewendet werden.

  • Kombinieren Sie keine Translate*-Werte mit TranslateRails*-Werten, diese werden als gegenseitig ausschließende Werte behandelt.
  • Kombinieren Sie die Trägheitswerte nicht mit den Nicht-Inertialwerten.
  • Der All-Wert ist nicht der wahre additive Wert aller Flags (wenn Werte bitweise verglichen werden). Der Wert All gibt nicht unbedingt an, dass die Kombination aller Werte gültig ist oder dass ein bestimmter Wert festgelegt ist.

Hinweise zu früheren Versionen

Windows 8.x Bei Windows 8 wird durch Festlegen von ManipulationMode auf einen Wert, der System mit einem anderen Wert kombiniert, eine Ausnahme ausgelöst, sodass einige der oben genannten Kombinationen für Windows 8 nicht funktionieren. Ab Windows 8.1 können Sie System mit anderen Werten kombinieren.

Apps, die für Windows 8 kompiliert wurden, aber auf Windows 8.1 ausgeführt werden, verwenden das neue Verhalten und ermöglichen die Kombination von System mit anderen Werten.

Gilt für:

Weitere Informationen