ItemsRepeaterScrollHost 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

用于协调 ItemsRepeater 和 ScrollViewer 之间的交互的帮助程序。 如果你的应用将在 1809 Windows 10 1809 (内部版本 17763) 上运行，请使用 ItemsRepeaterScrollHost。 如果你的应用仅在 Windows 1809 或更高版本的版本上运行，则无需使用此控件。

本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。

public ref class ItemsRepeaterScrollHost sealed : FrameworkElement

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ItemsRepeaterScrollHost final : FrameworkElement

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public sealed class ItemsRepeaterScrollHost : FrameworkElement

Public NotInheritable Class ItemsRepeaterScrollHost
Inherits FrameworkElement

继承

FrameworkElement

ItemsRepeaterScrollHost

属性

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 ItemsRepeater。

WinUI 3 库和 WinUI 2 库应用包括大多数 WinUI 3 和 WinUI 2 控件、特性和功能的交互式示例。

如果已安装，请单击以下链接将其打开：WinUI 3 库或 WinUI 2 库。

如果未安装，可以从 Microsoft Store 下载 WinUI 3 库和 WinUI 2 库。

还可以从 GitHub 获取这两种应用的源代码（对 WinUI 3 使用 main 分支，对 WinUI 2 使用 winui2 分支）。

此示例显示可滚动的人员列表。

<Page
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls">

    <muxc:ItemsRepeaterScrollHost>
        <ScrollViewer>
            <muxc:ItemsRepeater ItemsSource='{x:Bind PeopleCollection}' />
        </ScrollViewer>
    </muxc:ItemsRepeaterScrollHost> 

</Page

注解

ItemsRepeaterScrollHost 是一个帮助程序类，可用于包装 ScrollViewer 并在早期版本的 Windows 10上提供新 API 的功能。

从 Windows 10 版本 1809 (SDK 17763) 开始，ScrollViewer 具有用于协调 ItemsRepeater 与 ScrollViewer 之间的交互的属性。 如果你的应用面向版本 1809 (SDK 17763) 之前的Windows 10版本，请将 ScrollViewer 包装在 ItemsRepeaterScrollHost 中以提供这些 API 的功能。 ItemsRepeaterScrollHost 上的属性复制与 ScrollViewer 上发现的类似命名的属性相同的功能和行为。

如果应用的最低目标版本Windows 10 版本 1809 (SDK 17763) 或更高版本，则无需使用此控件。

构造函数

ItemsRepeaterScrollHost()

初始化 ItemsRepeaterScrollHost 类的新实例。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。

属性

CurrentAnchor	用于滚动定位的当前所选定位点元素。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。
HorizontalAnchorRatio	确定 ScrollViewer 定位点 相对于视区的水平位置。 默认情况下，ScrollViewer 通过将视区中的元素标识到离定位点最近的视区中，选择一个元素作为其 CurrentAnchor 。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。
ScrollViewer	获取或设置要承载的 ScrollViewer 。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。
VerticalAnchorRatio	确定 ScrollViewer 定位点 相对于视区的垂直位置。 默认情况下，ScrollViewer 通过将视区中的元素标识到离定位点最近的视区中，选择一个元素作为其 CurrentAnchor 。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。