UIElement.PointerReleased É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 l’appareil pointeur qui a lancé précédemment une action Press est libéré, tandis qu’au sein de cet élément. Notez que la fin d’une action De presse n’est pas garantie de déclencher un PointerReleased événement ; d’autres événements peuvent se déclencher à la place. Pour plus d’informations, consultez Remarques.
public:
virtual event PointerEventHandler ^ PointerReleased;// Register
event_token PointerReleased(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerReleased(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerReleased;function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;Public Custom Event PointerReleased As PointerEventHandler <uiElement PointerReleased="eventhandler"/>
Type d’événement
Remarques
Les interactions tactiles, souris et stylet/stylet sont reçues, traitées et gérées en tant qu’entrée de pointeur dans une application. L’une de ces interactions peut produire un PointerReleased événement. Pour plus d’informations, consultez Gérer l’entrée du pointeur.
D’autres événements peuvent se PointerReleased déclencher à la fin de l’action, par exemple PointerCanceled ou PointerCaptureLost. Ne vous appuyez pas sur PointerPressed et PointerReleased les événements se produisent toujours en paires. Pour fonctionner correctement, votre application doit écouter et gérer tous les événements qui représentent des conclusions probables de l’action Press . Voici quelques-unes des raisons pour lesquelles vous risquez de ne pas avoir d’occurrence PointerReleased :
- Différences dans la façon dont le matériel spécifique gère les actions tactiles et les actions de presse
- Capture de pointeur programmatique à partir d’un autre pointeur
- Actions utilisateur qui modifient la relation de la zone d’affichage, telles que la modification des paramètres de résolution ou de surveillance
- Interactions d’entrée telles qu’un stylet touchant la même surface qu’une action tactile précédente
L’action de l’utilisateur qui déclenche initialement un PointerReleased événement peut entraîner l’événement, ou peut également entraîner des RightTapped conditions qui varient selon l’appareilTapped. Pour plus d’informations, consultez Tapped et RightTapped.
L’entrée de la souris est associée à un pointeur unique affecté lorsque l’entrée de la souris est détectée pour la première fois. Cliquer sur un bouton de la souris (gauche, roue ou droite) crée une association secondaire entre le pointeur et ce bouton via l’événement PointerPressed . L’événement PointerReleased est déclenché uniquement lorsque ce même bouton de la souris est libéré (aucun autre bouton ne peut être associé au pointeur jusqu’à ce que cet événement soit terminé). En raison de cette association exclusive, d’autres clics de bouton de souris sont routés via l’événement PointerMoved . Vous pouvez tester l’état du bouton de la souris lors de la gestion de cet événement, comme illustré dans l’exemple suivant.
PointerReleased est un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez la vue d’ensemble des événements routés et des événements routés.
Pour les actions tactiles et également pour les événements d’interaction spécifiques ou de manipulation qui sont des conséquences d’une action tactile, un élément doit être visuellement détectable pour ê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 des types dérivés affectent également la visibilité des tests de positionnement. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.
PointerReleased 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. Voir AddHandler.
Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur des classes pour l’événement d’entréePointerReleased. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnPointerReleased. En règle générale, l’événement est marqué géré par le gestionnaire de classes et l’événement PointerReleased n’est pas déclenché pour la gestion par des gestionnaires de code utilisateur sur ce contrôle. Pour plus d’informations sur le fonctionnement de la gestion basée sur des classes pour les événements, consultez La vue d’ensemble des événements routés et des événements routés.
Les contrôles peuvent également avoir une animation de personnalité PointerUpThemeAnimation qui s’exécute indépendamment de l’événement.