Sprache

UIElement.ManipulationMode Eigenschaft

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Dient zum Abrufen oder Festlegen des ManipulationModes-Werts , der für uiElement-Verhalten und Interaktion mit Gesten verwendet wird. Das Festlegen dieses Werts ermöglicht das Behandeln der Manipulationsereignisse aus diesem Element 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 Werte der Enumeration. Der Standardwert ist in der Regel "System", dies kann jedoch von bestimmten Steuerelementen und Elementen variieren. Siehe Anmerkungen.

Hinweise

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

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

Schieberegler und ToggleSwitch verfügen über Standardvorlagen, die den ManipulationMode-Wert Nonefestlegen. Dies ist also None der Standardwert, den Sie zur Entwurfszeit sehen.

Sie können mehr als einen der Flagwise ManipulationModes-Werte als Wert der ManipulationMode Eigenschaft angeben. Dies ist in XAML mithilfe der im Abschnitt "XAML-Werte" dargestellten Kommasyntax möglich. Sie können z. B. eine beliebige Kombination dieser Kombinationen kombinierenTranslateXRotateTranslateYScale. Es sind jedoch nicht alle Kombinationen gültig. Gültigkeit wird nur einmal ManipulationModes durch ein bestimmtes Steuerelement erzwungen, sodass Probleme beim Festlegen einer ungültigen Kombination von ManipulationModes möglicherweise erst angezeigt werden, wenn Werte angewendet werden.

  • Kombinieren Sie Translate*-Werte nicht mit TranslateRails*-Werten, diese werden als sich gegenseitig ausschließende Werte behandelt.
  • Kombinieren Sie die Inertialwerte nicht mit den nicht inertialen Werten.
  • Der Wert "All " ist nicht der wahre Additive Wert aller Flags (wenn Werte bitweise verglichen werden). Ein Wert von "All " gibt nicht unbedingt an, dass die Kombination aller Werte gültig ist oder dass ein bestimmter Wert festgelegt ist.

Gilt für:

Weitere Informationen