通过

UIElement.BringIntoViewRequested 事件

  • 参考

定义

命名空间:
Windows.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>

Windows 要求

设备系列
Windows 10, version 1803 (在 10.0.17134.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v6.0 中引入)

注解

注意

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

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

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

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

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

适用于

另请参阅