ItemsRepeater 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示包含彈性版面配置系統、自訂檢視和虛擬化的資料驅動集合控制項，沒有預設 UI 或互動原則。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱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 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

屬性

Background	取得或設定提供控制項背景的筆刷。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
BackgroundProperty	識別 Background 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HorizontalCacheLength	取得或設定值，這個值表示在水準移動流覽或捲動時用來實現專案的緩衝區大小。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HorizontalCacheLengthProperty	識別 HorizontalCacheLength 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsSource	取得或設定用來產生 ItemsRepeater 內容的物件來源。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsSourceProperty	識別 ItemsSource 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsSourceView	取得指定 ItemsSource 物件與 ItemsRepeater 控制項與其相關聯元件之間所支援互動的標準化檢視。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemTemplate	取得或設定用來顯示每個專案的範本。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemTemplateProperty	識別 ItemTemplate 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Layout	取得或設定在 ItemsRepeater 中用來調整大小和位置專案的版面配置。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
LayoutProperty	識別 Layout 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
VerticalCacheLength	取得或設定值，這個值表示在垂直移動流覽或捲動時用來實現專案的緩衝區大小。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
VerticalCacheLengthProperty	識別 VerticalCacheLength 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

方法

GetElementIndex(UIElement)	從對應至指定 UIElement 的資料來源擷取專案的索引。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
GetOrCreateElement(Int32)	擷取對應至資料來源中指定索引處專案的 UIElement。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
TryGetElement(Int32)	擷取與資料來源中指定索引處的專案對應的實現 UIElement。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

事件

ElementClearing	每次清除元素並可供重複使用時發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ElementIndexChanged	當所代表專案的索引已變更時，就會針對每個實現的 UIElement 發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ElementPrepared	每次準備專案以供使用時發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• ItemsRepeater 指導方針