UIElement.BringIntoViewRequested Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn StartBringIntoView für dieses Element oder eines seiner abhängigen Elemente 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

TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs>

Hinweise

Hinweis

Das Framework kann das Ereignis auch als Reaktion darauf auslösen, dass das Element den Fokus über eine Tastatur oder einen Gamecontroller 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 des Anzeigens 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. Nicht scrollende Steuerelemente 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 das TargetRect-Element zu vergrößern und sicherzustellen, dass eine mindeste Menge an Auffüllung enthalten ist, wenn eines der untergeordneten Elemente angezeigt wird.

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 ändert, um seinen Beitrag zu berücksichtigen, unabhängig davon, ob es die Anforderung teilweise oder vollständig erfüllt. Es wird mindestens erwartet, dass sich ein Scroller als TargetElement festlegen und TargetRect in seinen eigenen Koordinatenraum aktualisiert. Für Situationen, in denen sich das Element in einem Scroller befindet, der sich selbst innerhalb eines Scrollers befindet, muss jedes 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 als Ereignisblasen geändert werden kann.

BringIntoViewRequested ist ein Routingereignis. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

Gilt für:

Weitere Informationen