UIElement.BringIntoViewRequested Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando StartBringIntoView viene chiamato su questo elemento o su uno dei relativi discendenti.
// 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 evento
Requisiti Windows
| Famiglia di dispositivi |
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)
|
Commenti
Nota
Il framework può anche generare l'evento in risposta all'elemento che riceve lo stato attivo tramite una tastiera o un game pad oppure quando una tecnologia assistive esegue il metodo ScrollIntoView di IScrollItemProvider nel peer di automazione dell'elemento.
Questo evento consente a un controllo di partecipare al processo di visualizzazione di un elemento. Indica a un controllo padre, ad esempio ScrollViewer, che l'elemento che ha generato l'evento deve essere reso visibile all'interno dell'area scorrevole. I controlli senza scorrimento possono usare l'evento come metodo per modificare le richieste provenienti da uno dei relativi elementi figlio modificando i dati dell'evento (BringIntoViewRequestedEventArgs). Ad esempio, è possibile ascoltare l'evento su un elemento padre per ingrandire TargetRect e assicurarsi che venga inclusa una quantità minima di spaziatura interna quando si inserisce uno dei relativi elementi figlio in visualizzazione.
In generale, i dati dell'evento (BringIntoViewRequestedEventArgs) non devono essere contrassegnati come gestiti. In questo modo è possibile interferire con l'obiettivo previsto quando è stato chiamato StartBringIntoView. È possibile modificare altri dati dell'evento man mano che l'evento viene modificato per modificare la richiesta. In particolare, è previsto che un controllo di scorrimento padre modifichi i dati dell'evento in modo che tengano conto del relativo contributo, sia che soddisfi parzialmente o completamente la richiesta. Come minimo, è previsto che uno scorrimento si imposti come TargetElement e aggiorni TargetRect allo spazio delle coordinate. Per le situazioni in cui l'elemento si trova all'interno di uno scorrimento all'interno di un controllo di scorrimento, ognuno deve reagire per soddisfare l'allineamento richiesto.
L'oggetto OriginalSource deve essere usato per determinare l'elemento in cui è stato generato l'evento in origine, dato che TargetElement può essere modificato come bolle di evento.
BringIntoViewRequested è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.