UIElement.ManipulationMode Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml

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à

ManipulationModes

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 ManipulationMode su un valore diverso da System 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 valore System abilita anche le animazioni di personalità che rispondono agli eventi di manipolazione.

Slider e ToggleSwitch hanno modelli predefiniti che impostano il valore ManipulationMode su Nessuno, quindi Nessuno sarà il valore predefinito visualizzato in fase di progettazione.

Specifica delle modalità di manipolazione correlate

È possibile specificare più valori ManipulationModes flagwise come valore della proprietà ManipulationMode. 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 solo una volta che ManipulationModes viene usato 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.

Note per le versioni precedenti

Windows 8.x In Windows 8, l'impostazione di ManipulationMode su un valore che combina System con qualsiasi altro valore genererà un'eccezione, quindi alcune delle combinazioni indicate in precedenza non funzioneranno per Windows 8. A partire da Windows 8.1, è possibile combinare System con altri valori.

Le app compilate per Windows 8 ma in esecuzione in Windows 8.1 usano il nuovo comportamento e consentono di combinare System con altri valori.

Vedi anche

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Gestire l'input del puntatore
• Informazioni di riferimento sulla manipolazione diretta
• Esempio di input di base (Windows 10)