VirtualizingLayout 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示物件的基類，該物件會調整及排列主機的子項目，並支援虛擬化。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class VirtualizingLayout : Layout

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class VirtualizingLayout : Layout

Public Class VirtualizingLayout
Inherits Layout

繼承

DependencyObject

Layout

VirtualizingLayout

衍生

Microsoft.UI.Xaml.Controls.FlowLayout

Microsoft.UI.Xaml.Controls.StackLayout

Microsoft.UI.Xaml.Controls.UniformGridLayout

屬性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 版面配置。

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、特性和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支和 WinUI 2) 的 winui2 分支。

備註

VirtualizingLayout 是支援虛擬化之版面配置的基類。 您可以使用其中一個提供的衍生類別，或繼承自該類別來建立您自己的配置。 提供的具體虛擬化版面配置類別為 StackLayout和 UniformGridLayout。

建構函式

VirtualizingLayout()

初始化 VirtualizingLayout 類別的新實例。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

方法

Arrange(LayoutContext, Size)	放置子項目，並決定容器 UIElement 的大小。 支援附加配置的容器元素應該從其版面配置覆寫實作呼叫此方法，以形成遞迴版面配置更新。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)	在衍生類別中實作時，提供配置「排列」階段的行為。 類別可以覆寫這個方法，以定義自己的「排列」傳遞行為。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InitializeForContext(LayoutContext)	初始化配置附加至 UIElement 容器時所需的任何個別容器狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
InitializeForContextCore(VirtualizingLayoutContext)	在衍生類別中覆寫時，初始化配置附加至 UIElement 容器時所需的任何個別容器狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InvalidateArrange()	使參考此配置之所有 UIElement 容器的排列狀態 (配置) 失效。 失效之後，UIElement 會更新其版面配置，這會以非同步方式發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
InvalidateMeasure()	使參考此配置之所有 UIElement 容器的度量狀態 (配置) 失效。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
Measure(LayoutContext, Size)	建議容器專案的 DesiredSize。 支援附加配置的容器元素應該從自己的 MeasureOverride 實作呼叫這個方法，以形成遞迴配置更新。 附加的配置預期會呼叫每個容器 UIElement 子系的 Measure。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
MeasureOverride(VirtualizingLayoutContext, Size)	提供配置週期的「量值」階段行為。 類別可以覆寫這個方法，以定義自己的「量值」傳遞行為。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	當指派給 Container 元素的資料收集 (ItemsSource) 變更時，通知配置。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
UninitializeForContext(LayoutContext)	移除先前儲存在 UIElement 容器上之配置的任何狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
UninitializeForContextCore(VirtualizingLayoutContext)	在衍生類別中覆寫時，移除先前儲存在 UIElement 容器上配置的任何狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

事件

ArrangeInvalidated	發生于配置 () 已失效時。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)
MeasureInvalidated	發生于 (配置) 的測量狀態已失效時。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 Layout)