Layout 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示物件基類，該物件會調整和排列主機的子專案大小。

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

public ref class Layout : DependencyObject

/// [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 Layout : DependencyObject

[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 Layout : DependencyObject

Public Class Layout
Inherits DependencyObject

繼承

DependencyObject

Layout

衍生

Microsoft.UI.Xaml.Controls.NonVirtualizingLayout

Microsoft.UI.Xaml.Controls.VirtualizingLayout

屬性

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 分支。

備註

您不應該直接使用或繼承自 Layout 類別。 相反地，繼承自其衍生類別 NonVirtualizingLayout 或 VirtualizingLayout。

提供的具體版面配置類別為 StackLayout和 UniformGridLayout。

方法

Arrange(LayoutContext, Size)	放置子專案，並決定容器 UIElement 的大小。 支援附加版面配置的容器元素應該從其版面配置覆寫實作呼叫此方法，以形成遞迴版面配置更新。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InitializeForContext(LayoutContext)	初始化配置附加至 UIElement 容器時所需的任何個別容器狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InvalidateArrange()	使參考此配置之所有 UIElement 容器的排列狀態 (配置) 失效。 無效之後，UIElement 會更新其版面配置，這會以非同步方式發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InvalidateMeasure()	使參考此配置之所有 UIElement 容器的度量狀態 (配置) 失效。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Measure(LayoutContext, Size)	建議容器專案的 DesiredSize。 支援附加配置的容器元素應該從自己的 MeasureOverride 實作呼叫此方法，以形成遞迴版面配置更新。 附加的版面配置預期會針對每個容器的 UIElement 子系呼叫 Measure。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
UninitializeForContext(LayoutContext)	移除先前儲存在 UIElement 容器上之版面配置的任何狀態。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

事件

ArrangeInvalidated	發生于排列狀態 (版面配置) 已失效時。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MeasureInvalidated	發生于 (版面配置) 已失效時。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• NonVirtualizingLayout
• VirtualizingLayout