UIElement.PointerReleased Événement

Définition

Se produit lorsque l’appareil pointeur qui a précédemment lancé une action Appuyer est libéré, dans cet élément. Notez que la fin d’une action Press n’est pas garantie pour 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 de pointeur.

D’autres événements au lieu de PointerReleased peuvent se déclencher à la fin de l’action, par exemple PointerCanceled ou PointerCaptureLost. Ne vous fiez pas à PointerPressed et PointerReleased aux événements qui se produisent toujours par paires. Pour fonctionner correctement, votre application doit écouter et gérer tous les événements qui représentent les conclusions probables de l’action Presse . Voici quelques-unes des raisons pour lesquelles vous n’obtenez peut-être pas d’occurrence PointerReleased :

  • Différences dans la façon dont un matériel spécifique gère les actions tactiles et les actions d’appui
  • Capture de pointeur programmatique à partir d’un autre pointeur
  • Actions de l’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 Tapped , ou peut également entraîner des RightTapped conditions qui varient selon l’appareil. Pour plus d’informations, consultez Tapped et RightTapped.

L’entrée de la souris est associée à un seul pointeur affecté lors de la première détection de l’entrée de la souris. Cliquer sur un bouton de souris (gauche, roulette ou droit) 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 relâché (aucun autre bouton ne peut être associé au pointeur tant que cet événement n’est pas terminé). En raison de cette association exclusive, les 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 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 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 de l’événement sont marquées Handled. Consultez 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é comme géré par le gestionnaire de classe, et l’événement PointerReleased n’est pas déclenché pour être géré par des gestionnaires de code utilisateur sur ce contrôle. Pour plus d’informations sur le fonctionnement de la gestion basée sur les classes des événements, consultez Vue d’ensemble des événements 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.

S’applique à

Voir aussi