UIElement.ManipulationMode Propiedad

Definición

Espacio de nombres:

Windows.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 ManipulationMode en un valor distinto de System 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 ManipulationMode es System en lugar de None. 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 valor del sistema también permite animaciones de personalidad que responden a eventos de manipulación.

Slider y ToggleSwitch tienen plantillas predeterminadas que establecen el valor ManipulationMode en None, 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 el valor de la propiedad ManipulationMode. 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, Rotate y Scale, o cualquier combinación de estos. Sin embargo, no todas las combinaciones son válidas. La validez se aplica solo una vez que un control específico usa ManipulationModes , por lo que es posible que los problemas con la configuración de una combinación no válida de ManipulationModes no aparezcan hasta que se apliquen valores en tiempo de 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.

Notas de las versiones anteriores

Windows 8.x En Windows 8, establecer ManipulationMode en un valor que combine System con cualquier otro valor producirá una excepción, por lo que algunas de las combinaciones mencionadas anteriormente no funcionarán para Windows 8. A partir de Windows 8.1, puede combinar System con otros valores.

Las aplicaciones compiladas para Windows 8 pero que se ejecutan en Windows 8.1 usan el nuevo comportamiento y permiten combinar System con otros valores.

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)