UIElement.ManipulationStarting Evento

Definición

Espacio de nombres:

Windows.UI.Xaml

Se produce cuando se crea por primera vez el procesador de manipulación.

public:
 virtual event ManipulationStartingEventHandler ^ ManipulationStarting;

// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;

// Revoke with event_token
void ManipulationStarting(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;

public event ManipulationStartingEventHandler ManipulationStarting;

function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;

Public Custom Event ManipulationStarting As ManipulationStartingEventHandler 

<uiElement ManipulationStarting="eventhandler"/>

Tipo de evento

ManipulationStartingEventHandler

Comentarios

Para conocer los controles personalizados y las experiencias de interacción, consulte GestureRecognizer.

Un elemento debe tener un valor ManipulationMode distinto de None o System para ser un origen de eventos de manipulación. El valor predeterminado de ManipulationMode es System, que permite que la lógica de control integrada procese manipulaciones, pero no permite que el código de la aplicación controle los eventos de manipulación. Si desea controlar manipulaciones, establezca ManipulationMode en All o en valores ManipulationModes específicos. Para obtener más información, consulta ManipulationMode.

ManipulationStarting se desencadena básicamente en cualquier momento en que un puntero interactúe con un elemento en el que el elemento habilita la manipulación. Esto incluye casos en los que la manipulación se interpreta como un gesto y los punteros nunca se mueven, por ejemplo, un gesto Pulsado o Presionado . Si los punteros se mueven, ManipulationStarted normalmente se activa después.

ManipulationStarting es un evento enrutado. Si el evento puede propagarse hasta elementos primarios porque no se controla, es posible controlar el evento en los elementos primarios incluso si ManipulationMode es None o System en el elemento primario. Para obtener más información sobre el concepto de evento enrutado, consulta Información general sobre eventos y eventos enrutados.

En el caso de las acciones táctiles y también de los eventos de manipulación o específicos de la interacción que son consecuencia de una acción táctil, un elemento debe ser visible en la prueba de acceso para poder ser origen de eventos y generar el evento que está asociado a la acción. UIElement.Visibility debe ser Visible. Otras propiedades de los tipos derivados también afectan a la visibilidad de las pruebas de posicionamiento. Para obtener más información, consulta Introducción a eventos y eventos enrutados.

ManipulationStarting admite la capacidad de adjuntar controladores de eventos a la ruta que se invocará incluso si los datos del evento se marcan como Handled. Consulte AddHandler.

Comportamiento de Windows 8

Windows 8 tuvo un problema al desencadenar este evento si se produjeron varios gestos en un breve período de tiempo. Por ejemplo, Windows 8 solo podría activar ManipulationStarting para el primer gesto y no para el segundo. El problema se ha corregido a partir de Windows 8.1; varios gestos iniciales procesados por el sistema de entrada activan cada uno un evento ManipulationStarting distinto.

Las aplicaciones compiladas para Windows 8 que se ejecuten en Windows 8.1 siguen usando el comportamiento de Windows 8.

Consulte también

• ManipulationStartingRoutedEventArgs
• OnManipulationStarting(ManipulationStartingRoutedEventArgs)
• ManipulationStarted
• Uso de eventos de manipulación
• Ejemplo de eventos de entrada de usuario XAML