ItemsRepeater 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

表示一个数据驱动的集合控件，该控件包含灵活的布局系统、自定义视图和虚拟化，没有默认的 UI 或交互策略。

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ItemTemplate")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ItemsRepeater : FrameworkElement

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ItemTemplate")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ItemsRepeater : FrameworkElement

Public Class ItemsRepeater
Inherits FrameworkElement

继承

FrameworkElement

ItemsRepeater

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 项重复程序。

打开 WinUI 2 库应用，查看 ItemsRepeater 的运行情况。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

虽然 ItemsRepeater 可用于呈现一组基本项，但它通常只是你自己的基于集合的独特体验的构建基块，并且最常用作自定义控件模板中的显示元素。

ItemsRepeater 在附加到支持虚拟化的主机时支持虚拟化。

构造函数

ItemsRepeater()

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

属性

Background	获取或设置提供控件背景的画笔。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
BackgroundProperty	标识 Background 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HorizontalCacheLength	获取或设置一个值，该值指示水平平移或滚动时用于实现项的缓冲区的大小。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HorizontalCacheLengthProperty	标识 HorizontalCacheLength 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ItemsSource	获取或设置用于生成 ItemsRepeater 内容的对象源。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ItemsSourceProperty	标识 ItemsSource 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ItemsSourceView	获取给定 ItemsSource 对象与 ItemsRepeater 控件及其关联组件之间支持的交互的标准化视图。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ItemTemplate	获取或设置用于显示每个项的模板。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateProperty	标识 ItemTemplate 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Layout	获取或设置用于调整 ItemsRepeater 中元素的大小和位置的布局。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
LayoutProperty	标识 Layout 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
VerticalCacheLength	获取或设置一个值，该值指示在垂直平移或滚动时用于实现项的缓冲区的大小。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
VerticalCacheLengthProperty	标识 VerticalCacheLength 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

方法

GetElementIndex(UIElement)	从与指定的 UIElement 相对应的数据源中检索项的索引。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
GetOrCreateElement(Int32)	检索与数据源中指定索引处的项对应的 UIElement。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TryGetElement(Int32)	检索与数据源中指定索引处的项相对应的已实现 UIElement。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

事件

ElementClearing	每次清除元素并可供重用时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ElementIndexChanged	当每个实现的 UIElement 所表示的项的索引发生更改时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ElementPrepared	每次准备好使用元素时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• ItemsRepeater 指南