UIElement.BringIntoViewRequested 事件

  • 参考

定义

命名空间:
Microsoft.UI.Xaml
编辑

在此元素或其后代之一上调用 StartBringIntoView 时发生。

// 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)

事件类型

TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs>

注解

注意

框架还可能引发 事件，以响应通过键盘或游戏控制器接收焦点的元素，或者当辅助技术在元素的自动化对等上执行 IScrollItemProvider 的 ScrollIntoView 方法时。

此事件使控件能够参与将元素引入视图的过程。 它向父控件（如 ScrollViewer）指示引发事件的元素应在可滚动区域内可见。 非滚动控件可以使用 事件作为一种方法，通过修改 BringIntoViewRequestedEventArgs) 的事件数据 (来更改源自其子级之一的请求。 例如，可以侦听父元素上的 事件以放大 TargetRect ，并确保在将父元素的任何子元素引入视图时包含最少的填充量。

通常，不应将 BringIntoViewRequestedEventArgs) 的事件数据 (标记为已处理。 调用 StartBringIntoView 时，这样做可能会干扰预期目标。 当事件向上冒泡以更改请求时，可能会修改其他事件数据。 具体而言，父滚动控件应修改事件数据，以考虑其贡献，无论是部分还是完全满足请求。 滚动器至少应将自身设置为 TargetElement ，并将 TargetRect 更新为自己的坐标空间。 如果元素位于滚动器内，而滚动器本身位于滚动器内，则每个元素都必须做出响应，以满足请求的对齐方式。

如果 TargetElement 可以修改为事件气泡，则 OriginalSource 应用于确定最初引发事件的元素。

BringIntoViewRequested 是路由事件。 有关路由事件概念的详细信息，请参阅 事件和路由事件概述。

适用于

另请参阅