UIElement.ManipulationMode Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Obtiene o establece el valor ManipulationModes usado para el comportamiento uiElement y la interacción con gestos. Establecer este valor permite controlar los eventos de manipulación de este elemento en el código de la aplicación.

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

Valor de propiedad

ManipulationModes

Valor o valores de la enumeración. El valor predeterminado suele ser System, pero esto puede variar en controles y elementos específicos. Vea la sección Comentarios.

Comentarios

Debes establecer en ManipulationMode un valor distinto System de o None si quieres controlar eventos de manipulación como ManipulationStarted desde elementos de la interfaz de usuario en el código de la aplicación. Para obtener más información sobre las manipulaciones, consulta Controlar la entrada del puntero.

El valor predeterminado típico de es en System lugar de .ManipulationModeNone Cuando el valor es System, las manipulaciones que se originan en el elemento se pueden controlar mediante la infraestructura de Windows Runtime, que se basa en direct Manipulation API. Por ejemplo, ScrollViewer controla las manipulaciones de usuario en su lógica de control y las procesa como acciones de desplazamiento para el control. El System valor también permite animaciones de personalidad que responden a eventos de manipulación.

Slider y ToggleSwitch tienen plantillas predeterminadas que establecen el valor NoneManipulationMode en , por lo que None será el valor predeterminado que verá en tiempo de diseño.

Especificación de modos de manipulación relacionados

Puede especificar más de uno de los valores ManipulationModes con marca como valor de la ManipulationMode propiedad . Esto es posible en XAML mediante la sintaxis de coma que se muestra en la sección "Valores XAML". Por ejemplo, puede combinar TranslateX, TranslateY, Rotatey Scale, o cualquier combinación de estos. Sin embargo, no todas las combinaciones son válidas. La validez se aplica solo una vez ManipulationModes que se usa en un control específico, por lo que es posible que los problemas con la configuración de una combinación no válida no aparezcan hasta que se apliquen valores en tiempo de ManipulationModes ejecución.

• No combine valores Translate* con valores TranslateRails*, que se tratan como valores mutuamente excluyentes.
• No combine los valores inerciales con los valores no inerciales.
• El valor All no es el valor de suma verdadero de todas las marcas (si se comparan valores bit a bit). Un valor de All no indica necesariamente que la combinación de todos los valores sea válida o que se establezca cualquier valor específico.

Consulte también

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Control de la entrada con puntero
• Referencia de manipulación directa
• Ejemplo de entrada básico (Windows 10)