Freigeben über


UIElement.BringIntoViewRequested Ereignis

Definition

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

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Hinweis

Das Framework kann das Ereignis auch als Reaktion darauf auslösen, dass das Element den Fokus über eine Tastatur oder ein Gamepad empfängt, oder wenn eine Hilfstechnologie die ScrollIntoView-Methode des IScrollItemProvider auf dem Automatisierungspeer des Elements ausführt.

Dieses Ereignis ermöglicht es einem Steuerelement, am Prozess zum Anzeigen eines Elements teilzunehmen. Es gibt für ein übergeordnetes Steuerelement, z. B. einen ScrollViewer, an, dass das Element, das das Ereignis ausgelöst hat, innerhalb des scrollbaren Bereichs sichtbar gemacht werden soll. Steuerelemente ohne Bildlauf können das -Ereignis als Möglichkeit verwenden, Anforderungen zu ändern, die von einem seiner untergeordneten Elemente stammen, indem sie die Ereignisdaten ändern (BringIntoViewRequestedEventArgs). Sie können z. B. auf das Ereignis eines übergeordneten Elements lauschen, um targetRect zu vergrößern und sicherzustellen, dass beim Anzeigen der untergeordneten Elemente eine mindeste Auffüllung enthalten ist.

Im Allgemeinen sollten die Ereignisdaten (BringIntoViewRequestedEventArgs) nicht als behandelt gekennzeichnet werden. Dies kann das beabsichtigte Ziel beeinträchtigen, wenn StartBringIntoView aufgerufen wurde. Andere Ereignisdaten können geändert werden, wenn das Ereignis in eine Blasenblase wechselt, um die Anforderung zu ändern. Insbesondere wird erwartet, dass ein übergeordnetes Scrollsteuerelement die Ereignisdaten so ändert, dass es seinen Beitrag berücksichtigt, unabhängig davon, ob es die Anforderung teilweise oder vollständig erfüllt. Es wird mindestens erwartet, dass ein Scroller sich selbst als TargetElement festgelegt und TargetRect in seinen eigenen Koordinatenbereich aktualisiert. In Situationen, in denen sich das Element in einem Scroller befindet, der sich selbst innerhalb eines Scrollers 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 targetElement als Ereignisblase geändert werden kann.

BringIntoViewRequested ist ein Routingereignis. Weitere Informationen zum Konzept von Routingereignissen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Gilt für:

Weitere Informationen