UIElement.BringIntoViewRequested É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 StartBringIntoView est appelé sur cet élément ou l’un de ses descendants.
// Register
event_token BringIntoViewRequested(TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;
// Revoke with event_token
void BringIntoViewRequested(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::BringIntoViewRequested_revoker BringIntoViewRequested(auto_revoke_t, TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;public event TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs> BringIntoViewRequested;function onBringIntoViewRequested(eventArgs) { /* Your code */ }
uIElement.addEventListener("bringintoviewrequested", onBringIntoViewRequested);
uIElement.removeEventListener("bringintoviewrequested", onBringIntoViewRequested);
- or -
uIElement.onbringintoviewrequested = onBringIntoViewRequested;Public Custom Event BringIntoViewRequested As TypedEventHandler(Of UIElement, BringIntoViewRequestedEventArgs) Type d'événement
Configuration requise pour Windows
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v6.0)
|
Remarques
Notes
L’infrastructure peut également déclencher l’événement en réponse à l’élément recevant le focus via un clavier ou un boîtier de commande, ou lorsqu’une technologie d’assistance exécute la méthode ScrollIntoView de IScrollItemProvider sur l’homologue Automation de l’élément.
Cet événement permet à un contrôle de participer au processus d’affichage d’un élément. Il indique à un contrôle parent, tel qu’un ScrollViewer, que l’élément qui a déclenché l’événement doit être rendu visible dans la région avec défilement. Les contrôles sans défilement peuvent utiliser l’événement comme un moyen de modifier les requêtes provenant de l’un de ses enfants en modifiant les données d’événement (BringIntoViewRequestedEventArgs). Par exemple, vous pouvez écouter l’événement sur un élément parent pour agrandir targetRect et vous assurer qu’une quantité minimale de remplissage est incluse lors de l’affichage de l’un de ses éléments enfants.
En général, les données d’événement (BringIntoViewRequestedEventArgs) ne doivent pas être marquées comme gérées. Cela peut interférer avec l’objectif prévu lors de l’appel de StartBringIntoView. D’autres données d’événement peuvent être modifiées à mesure que l’événement monte en bulles pour modifier la demande. Plus précisément, un contrôle de défilement parent est censé modifier les données d’événement pour tenir compte de sa contribution, qu’il réponde partiellement ou entièrement à la demande. Au minimum, un scroller doit se définir comme TargetElement et mettre à jour targetRect avec son propre espace de coordonnées. Pour les situations où l’élément se trouve dans un défilement qui se trouve lui-même dans un défilement, chacun doit réagir pour satisfaire l’alignement demandé.
L’OriginalSource doit être utilisé pour déterminer l’élément sur lequel l’événement a été déclenché à l’origine, étant donné que l’élément TargetElement peut être modifié en tant que bulles d’événements.
BringIntoViewRequested 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.