UIElement.ManipulationMode Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore ManipulationModes utilizzato per il comportamento uiElement e l'interazione con i movimenti. L'impostazione di questo valore consente di gestire gli eventi di manipolazione da questo elemento nel codice dell'app.
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"/>
Valore della proprietà
Valore o valori dell'enumerazione . L'impostazione predefinita è in genere System, ma può variare in base a controlli ed elementi specifici. Vedere la sezione Osservazioni.
Commenti
Devi impostare su ManipulationMode
un valore diverso System
da o None
se vuoi gestire eventi di manipolazione come ManipulationStarted dagli elementi dell'interfaccia utente nel codice dell'app. Per altre info sulle manipolazioni, vedi Gestire l'input del puntatore.
Il valore predefinito tipico di ManipulationMode
è System
anziché None
. Quando il valore è System
, le manipolazioni originate dall'elemento possono essere gestite dall'infrastruttura di Windows Runtime, basata sull'API manipolazione diretta.
Ad esempio, ScrollViewer gestisce le manipolazioni utente nella logica di controllo e le elabora come azioni di scorrimento per il controllo. Il System
valore abilita anche le animazioni di personalità che rispondono agli eventi di manipolazione.
Slider e ToggleSwitch hanno modelli predefiniti che impostano il valore ManipulationMode su None
, quindi None
sarà il valore predefinito visualizzato in fase di progettazione.
Specifica delle modalità di manipolazione correlate
È possibile specificare più valori ManipulationModes flagwise come valore della ManipulationMode
proprietà . Questo è possibile in XAML usando la sintassi della virgola illustrata nella sezione "Valori XAML". Ad esempio, è possibile combinare TranslateX
, TranslateY
, Rotate
e Scale
o qualsiasi combinazione di queste. Tuttavia, non tutte le combinazioni sono valide. La validità viene applicata una sola volta ManipulationModes
che viene usata da un controllo specifico, pertanto i problemi relativi all'impostazione di una combinazione non valida di ManipulationModes
potrebbero non essere visualizzati fino a quando i valori vengono applicati.
- Non combinare i valori Translate* con i valori TranslateRails*, questi valori vengono considerati come valori che si escludono a vicenda.
- Non combinare i valori inerziali con i valori non inerziali.
- Il valore All non è il valore aggiuntivo true di tutti i flag (se i valori vengono confrontati bit per bit). Il valore All non indica necessariamente che la combinazione di tutti i valori è valida o che è impostato un valore specifico.