UIElement.ManipulationMode Proprietà

Definizione

Spazio dei nomi:

Microsoft.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 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, Rotatee Scaleo 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.

Vedi anche

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