UIElement.BringIntoViewRequested Evento

Definição

Namespace:

Windows.UI.Xaml

Ocorre quando StartBringIntoView é chamado nesse elemento ou em um de seus descendentes.

// 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) 

Tipo de evento

TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs>

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Comentários

Observação

A estrutura também pode gerar o evento em resposta ao elemento que recebe o foco por meio de um teclado ou gamepad ou quando uma tecnologia adaptativa executa o método ScrollIntoView do IScrollItemProvider no par de automação do elemento.

Esse evento permite que um controle participe do processo de colocar um elemento em exibição. Indica a um controle pai, como um ScrollViewer, que o elemento que gerou o evento deve ficar visível dentro da região rolável. Controles sem rolagem podem usar o evento como uma maneira de alterar solicitações originadas de um de seus filhos modificando os dados do evento (BringIntoViewRequestedEventArgs). Por exemplo, você pode ouvir o evento em um elemento pai para ampliar o TargetRect e garantir que uma quantidade mínima de preenchimento seja incluída ao colocar qualquer um de seus elementos filho em exibição.

Em geral, os dados do evento (BringIntoViewRequestedEventArgs) não devem ser marcados como manipulados. Isso pode interferir na meta pretendida quando StartBringIntoView foi chamado. Outros dados de evento podem ser modificados à medida que o evento aumenta para alterar a solicitação. Especificamente, espera-se que um controle de rolagem pai modifique os dados do evento para levar em conta sua contribuição, independentemente de atender parcial ou totalmente à solicitação. No mínimo, espera-se que um scroller se defina como TargetElement e atualize o TargetRect para seu próprio espaço de coordenadas. Para situações em que o elemento está dentro de um scroller que está dentro de um scroller, cada um deve reagir para atender ao alinhamento solicitado.

O OriginalSource deve ser usado para determinar o elemento no qual o evento foi originalmente gerado, dado que o TargetElement pode ser modificado como as bolhas de evento.

BringIntoViewRequested é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

Confira também

• BringIntoViewRequestedEventArgs
• OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)