ScrollingAnchorRequestedEventArgs 类

  • 参考

定义

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

为 ScrollView.AnchorRequested 事件提供数据。

public ref class ScrollingAnchorRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScrollingAnchorRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScrollingAnchorRequestedEventArgs
Public NotInheritable Class ScrollingAnchorRequestedEventArgs
继承
Object Platform::Object IInspectable ScrollingAnchorRequestedEventArgs
属性
ContractVersionAttribute MarshalingBehaviorAttribute

注解

ScrollView.AnchorRequested 事件使用这些事件参数，该事件在 选择要定位的元素时ScrollView引发。 处理此事件以自定义该选择。

如果事件处理程序将 AnchorElement 保留为 null，则 ScrollView 将从 AnchorCandidates 集合中选择一个定位点。

集合 AnchorCandidates 使用注册为定位点候选项的元素进行初始化。 候选项的初始集合填充 ScrollPresenter 了其 UIElement.CanBeScrollAnchor 属性设置为 true的子级，以及使用 方法显式注册的 ScrollView.RegisterAnchorCandidate 元素。

可以使用 AnchorRequested 事件处理程序修改该集合，以调整定位点请求的候选项列表。 执行后， ScrollView 使用其 HorizontalAnchorRatio 和 VerticalAnchorRatio 属性在最终 AnchorCandidates 集合中选择一个定位点。

或者，可以使用 AnchorRequested 事件处理程序将初始化为 的 AnchorElement 属性设置为 null强制使用特定元素作为定位点。 在这种情况下， AnchorCandidates 将忽略集合并 ScrollView完全跳过 的选择过程。

属性

AnchorCandidates

获取要从中选取的定位点元素候选项的集合。
AnchorElement

获取或设置选定的定位点元素。

适用于

另请参阅