共用方式為


VirtualizingLayout 類別

定義

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

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class VirtualizingLayout : Layout
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public 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
繼承
VirtualizingLayout
衍生
屬性
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute 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 是支援虛擬化之版面配置的基類。 您可以使用其中一個提供的衍生類別,或繼承自該類別來建立您自己的配置。 提供的具體虛擬化版面配置類別為 StackLayoutUniformGridLayout

建構函式

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)

適用於