UIElement.ManipulationMode Propriété

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml
Modifier

Obtient ou définit la valeur ManipulationModes utilisée pour le comportement et l’interaction uiElement avec les mouvements. La définition de cette valeur permet de gérer les événements de manipulation de cet élément dans le code d’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 ManipulationMode sur 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 du pointeur.

La valeur par défaut classique de ManipulationMode est System plutôt que 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 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 valeur système 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. Aucun est donc la valeur par défaut que vous voyez au moment de la conception.

Vous pouvez spécifier plusieurs valeurs ManipulationModes au niveau de l’indicateur comme valeur de la propriété ManipulationMode. 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, Pivoter et Mettre à l’échelle, ou n’importe quelle combinaison de ceux-ci. Toutefois, toutes les combinaisons ne sont pas valides. La validité n’est appliquée qu’une fois que ManipulationModes est utilisé par un contrôle spécifique. Par conséquent, 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 d’inertie avec les valeurs non inertielles.
  • La valeur All n’est pas la valeur additive réelle 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.

Remarques pour les versions précédentes

Windows 8.x Sur Windows 8, définir ManipulationMode sur une valeur qui combine System avec n’importe quelle autre valeur lève une exception, de sorte que certaines des combinaisons mentionnées ci-dessus ne fonctionnent pas pour Windows 8. À partir de Windows 8.1, vous pouvez combiner System avec d’autres valeurs.

Les applications qui ont été compilées pour Windows 8 mais qui s’exécutent sur Windows 8.1 utilisent le nouveau comportement et permettent de combiner System avec d’autres valeurs.

S’applique à

Voir aussi