UniformGridLayout 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

在換行版面配置中，循序從左至右或從上到下放置元素。

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [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.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class UniformGridLayout : VirtualizingLayout

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[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.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class UniformGridLayout : VirtualizingLayout

Public Class UniformGridLayout
Inherits VirtualizingLayout

繼承

DependencyObject

Layout

VirtualizingLayout

UniformGridLayout

屬性

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

範例

提示

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

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

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

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

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

下列範例示範如何將 ItemsRepeater.Layout 屬性設定為 UniformGridLayout。

<!--
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
...
<muxc:ItemsRepeater ItemsSource="{x:Bind Items}"
                    ItemTemplate="{StaticResource MyTemplate}">
    <muxc:ItemsRepeater.Layout>
        <muxc:UniformGridLayout MinItemWidth="200"
                                MinColumnSpacing="28"
                                ItemsJustification="SpaceAround"/>
    </muxc:ItemsRepeater.Layout>
</muxc:ItemsRepeater>

備註

當 Orientation 為 Horizontal 時，專案會依左至右的順序配置，並在 Orientation 為 Vertical 時配置由上至下。

UniformGridLayout 中的每個專案大小都相同。

當附加至支援虛擬化的主機時，UniformGridLayout 支援虛擬化。

建構函式

UniformGridLayout()

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

屬性

ItemsJustification	取得或設定值，指出專案如何在非捲動或非虛擬化座標軸上對齊。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsJustificationProperty	識別 ItemsJustification 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsStretch	取得或設定值，指出專案的大小如何填滿可用空間。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ItemsStretchProperty	識別 ItemsStretch 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MaximumRowsOrColumns	根據 UniformGridLayout的方向，取得或設定每個資料列或資料行呈現的專案數目上限。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MaximumRowsOrColumnsProperty	識別 MaximumRowsOrColumns 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinColumnSpacing	取得或設定水準軸上專案之間的最小空間。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinColumnSpacingProperty	識別 MinColumnSpacing 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinItemHeight	取得或設定每個專案的最小高度。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinItemHeightProperty	識別 MinItemHeight 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinItemWidth	取得或設定每個專案的最小寬度。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinItemWidthProperty	識別 MinItemWidth 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinRowSpacing	取得或設定垂直軸上專案之間的最小空間。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MinRowSpacingProperty	識別 MinRowSpacing 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Orientation	取得或設定專案配置所在的座標軸。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
OrientationProperty	識別 Orientation 相依性屬性。 本檔適用于 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命名空間) 。 (繼承來源 VirtualizingLayout)
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命名空間) 。 (繼承來源 VirtualizingLayout)
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命名空間) 。 (繼承來源 VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	當指派給 Container 元素的資料收集 (ItemsSource) 變更時，通知配置。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。 (繼承來源 VirtualizingLayout)
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命名空間) 。 (繼承來源 VirtualizingLayout)

事件

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

另請參閱

• UniformGridLayoutItemsJustification
• UniformGridLayoutItemsStretch
• UniformGridLayout 概觀