UIElement.BringIntoViewRequested Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn StartBringIntoView für dieses Element oder eines seiner Nachfolger aufgerufen wird.
// 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) Ereignistyp
Hinweise
Hinweis
Das Framework kann das Ereignis auch als Reaktion auf das Element auslösen, das den Fokus über eine Tastatur oder einen Gamecontroller erhält, oder wenn eine Hilfstechnologie die ScrollIntoView-Methode des Elements auf dem Automatisierungspeer des Elements ausführt.
Dieses Ereignis ermöglicht es einem Steuerelement, an dem Prozess der Anzeige eines Elements teilzunehmen. Es gibt an, dass ein übergeordnetes Steuerelement, z. B. ein ScrollViewer, das Element, das das Ereignis ausgelöst hat, innerhalb des bildlauffähigen Bereichs sichtbar gemacht werden soll. Steuerelemente ohne Bildlauf können das Ereignis verwenden, um Anforderungen zu ändern, die von einem ihrer untergeordneten Elemente stammen, indem sie die Ereignisdaten ändern (BringIntoViewRequestedEventArgs). Sie können z. B. auf das Ereignis eines übergeordneten Elements lauschen, um das TargetRect-Element zu vergrößern und sicherzustellen, dass beim Anzeigen eines der untergeordneten Elemente eine Mindestmenge an Abstand enthalten ist.
Im Allgemeinen sollten die Ereignisdaten (BringIntoViewRequestedEventArgs) nicht als handled gekennzeichnet werden. Dies kann das beabsichtigte Ziel beeinträchtigen, als StartBringIntoView aufgerufen wurde. Andere Ereignisdaten können geändert werden, wenn die Ereignisblase die Anforderung ändern. Insbesondere wird erwartet, dass ein übergeordnetes Bildlaufsteuerelement die Ereignisdaten so ändern wird, dass er seinen Beitrag berücksichtigt, unabhängig davon, ob es die Anforderung teilweise oder vollständig erfüllt. Mindestens wird erwartet, dass ein Bildlaufer sich selbst als TargetElement festlegen und das TargetRect auf seinen eigenen Koordinatenbereich aktualisiert. In Situationen, in denen sich das Element innerhalb eines Bildlaufers befindet, der sich selbst innerhalb eines Bildlaufers befindet, muss jeder reagieren, um die angeforderte Ausrichtung zu erfüllen.
Die OriginalSource sollte verwendet werden, um das Element zu bestimmen, für das das Ereignis ursprünglich ausgelöst wurde, da das TargetElement möglicherweise als Ereignisblasen geändert werden kann.
BringIntoViewRequested ist ein Routingereignis. Weitere Informationen zum Routingereigniskonzept finden Sie unter "Ereignisse und Routingereignisse".