UIElement.ManipulationCompleted É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 lorsqu’une manipulation sur l’élément UIElement est terminée.
public:
virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;
// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;public event ManipulationCompletedEventHandler ManipulationCompleted;function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler <uiElement ManipulationCompleted="eventhandler"/>
Type d'événement
Remarques
Pour connaître les contrôles personnalisés et les expériences d’interaction, consultez GestureRecognizer.ManipulationCompleted.
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.
ManipulationCompleted 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.
ManipulationCompleted 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 ne déclenche pas ManipulationCompleted dans les cas où la phase d’inertie a démarré (et ManipulationInertiaStarting a déclenché), mais l’utilisateur a appuyé sur l’élément avant la fin du défilement, ce qui annule visuellement la phase d’inertie. Le problème est résolu en commençant par Windows 8.1 ; ManipulationCompleted est déclenché dès que l’action d’appui annule la phase d’inertie.
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.