UIElement.BringIntoViewRequested Evento

Definición

Espacio de nombres:

Windows.UI.Xaml

Se produce cuando se llama a StartBringIntoView en este elemento o en uno de sus descendientes.

// 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 de Windows

Familia de dispositivos	Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Comentarios

Nota

El marco también puede generar el evento en respuesta al elemento que recibe el foco a través de un teclado o controlador para juegos, o cuando una tecnología de asistencia ejecuta el método ScrollIntoView del IScrollItemProvider en el elemento del mismo nivel de automatización.

Este evento permite que un control participe en el proceso de incorporar un elemento a la vista. Indica a un control primario, como scrollViewer, que el elemento que generó el evento debe hacerse visible dentro de la región desplazable. Los controles que no se desplazan pueden usar el evento como una manera de modificar las solicitudes que se originan en uno de sus elementos secundarios modificando los datos del evento (BringIntoViewRequestedEventArgs). Por ejemplo, puede escuchar el evento en un elemento primario para ampliar TargetRect y asegurarse de que se incluye una cantidad mínima de relleno al incorporar cualquiera de sus elementos secundarios a la vista.

En general, los datos del evento (BringIntoViewRequestedEventArgs) no deben marcarse como controlado. Si lo hace, puede interferir con el objetivo previsto cuando se llamó a StartBringIntoView. Otros datos de eventos se pueden modificar a medida que el evento se propaga para modificar la solicitud. En concreto, se espera que un control de desplazamiento primario modifique los datos del evento para tener en cuenta su contribución, ya sea parcialmente o totalmente satisface la solicitud. Como mínimo, se espera que un scroller se establezca como TargetElement y actualice TargetRect a su propio espacio de coordenadas. En situaciones en las que el elemento está dentro de un scroller que se encuentra dentro de un desplazador, cada uno debe reaccionar para satisfacer la alineación solicitada.

OriginalSource debe usarse para determinar el elemento en el que se generó originalmente el evento, dado que targetElement se puede modificar como burbujas de evento.

BringIntoViewRequested es un evento enrutado. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.

Consulte también

• BringIntoViewRequestedEventArgs
• OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)