UIElement.ManipulationMode Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit la valeur ManipulationModes utilisée pour le comportement uiElement et l’interaction avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation à partir de cet élément dans le code de l’application.

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"/>

Valeur de propriété

ManipulationModes

Valeur ou valeurs de l’énumération. La valeur par défaut est généralement System, mais cela peut varier selon des contrôles et des éléments spécifiques. Consultez la section Notes.

Remarques

Vous devez définir sur ManipulationMode une valeur autre que System ou None si vous souhaitez gérer les événements de manipulation tels que ManipulationStarted à partir d’éléments d’interface utilisateur dans le code de votre application. Pour plus d’informations sur les manipulations, consultez Gérer l’entrée de pointeur.

La valeur par défaut standard de ManipulationMode est System au lieu de None. Lorsque la valeur est System, les manipulations qui proviennent de l’élément peuvent être gérées par l’infrastructure Windows Runtime, qui est basée sur l’API de manipulation directe. Par exemple, ScrollViewer gère les manipulations utilisateur dans sa logique de contrôle et les traite comme des actions de défilement pour le contrôle. La System valeur active également les animations de personnalité qui répondent aux événements de manipulation.

Slider et ToggleSwitch ont des modèles par défaut qui définissent la valeur ManipulationMode sur None, de sorte None que sera la valeur par défaut que vous verrez au moment du design.

Spécification des modes de manipulation associés

Vous pouvez spécifier plusieurs valeurs ManipulationModes au niveau de l’indicateur comme valeur de la ManipulationMode propriété . Cela est possible en XAML à l’aide de la syntaxe de virgule indiquée dans la section « Valeurs XAML ». Par exemple, vous pouvez combiner TranslateX, TranslateY, Rotateet Scale, ou n’importe quelle combinaison de ceux-ci. Toutefois, toutes les combinaisons ne sont pas valides. La validité n’étant appliquée qu’une fois ManipulationModes utilisée par un contrôle spécifique, les problèmes liés à la définition d’une combinaison non valide de ManipulationModes peuvent ne pas apparaître avant l’exécution lorsque des valeurs sont appliquées.

• Ne combinez pas les valeurs Translate* avec les valeurs TranslateRails*, elles sont traitées comme des valeurs mutuellement exclusives.
• Ne combinez pas les valeurs inertielles avec les valeurs non inertielles.
• La valeur All n’est pas la véritable valeur additive de tous les indicateurs (si les valeurs sont comparées au niveau du bit). La valeur All n’indique pas nécessairement que la combinaison de toutes les valeurs est valide ou qu’une valeur spécifique est définie.

Voir aussi

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Gestion des entrées du pointeur
• Informations de référence sur la manipulation directe
• Exemple d’entrée de base (Windows 10)