UIElement.ManipulationStarting Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque le processeur de manipulation est créé initialement.
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"/>
Type d'événement
Remarques
Pour connaître les contrôles personnalisés et les expériences d’interaction, consultez GestureRecognizer.
Un élément doit avoir une valeur ManipulationMode autre que None ou System pour être une source d’événement de manipulation. La valeur par défaut de ManipulationMode est System, qui permet à la logique de contrôle intégrée de traiter les manipulations, mais ne permet pas au code d’application de gérer les événements de manipulation. Si vous souhaitez gérer les manipulations, définissez ManipulationMode sur All ou sur des valeurs ManipulationModes spécifiques. Pour plus d’informations, consultez ManipulationMode.
ManipulationStarting se déclenche essentiellement chaque fois qu’un pointeur interagit avec un élément où l’élément permet la manipulation. Cela inclut les cas où la manipulation est interprétée comme un mouvement et où les pointeurs ne se déplacent jamais, par exemple un mouvement appuyé ou de maintien . Si les pointeurs se déplacent, ManipulationStarted se déclenche généralement par la suite.
ManipulationStarting est un événement routé. Si l’événement est autorisé à buller vers des éléments parents parce qu’il n’est pas pris en charge, il est possible de gérer l’événement sur les éléments parents même si ManipulationMode est None ou System sur l’élément parent. Pour plus d’informations sur le concept d’événement routé, consultez Vue d’ensemble des événements et des événements routés.
Pour les actions tactiles et pour les événements de manipulation ou spécifiques à l’interaction qui sont des conséquences d’une action tactile, un élément doit être visible au test de positionnement pour pouvoir être la source d’événement et déclencher l’événement associé à l’action. UIElement.Visibility doit être visible. D’autres propriétés de types dérivés affectent également la visibilité des tests d’accès. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.
ManipulationStarting prend en charge la possibilité d’attacher des gestionnaires d’événements à l’itinéraire qui sera appelé, même si les données d’événement de l’événement sont marquées Handled. Consultez AddHandler.
Comportement de Windows 8
Windows 8 a rencontré un problème avec le déclenchement de cet événement si plusieurs mouvements se sont produits dans un court laps de temps. Par exemple, Windows 8 peut uniquement déclencher ManipulationStarting pour le premier geste et non pour le second. Le problème est résolu à partir de Windows 8.1 ; plusieurs mouvements de démarrage traités par le système d’entrée déclenchent chacun un événement ManipulationStarting distinct.
Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.