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 使用 main 分支，对 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>

注解

按方向从左到右的顺序排列项目，并在方向Horizontal为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)	提供布局周期的“度量值”传递的行为。 类可以重写此方法以定义其自己的“Measure”传递行为。 本文档适用于 Windows 应用 SDK 中 WinUI 的 WinUI 2 for UWP (，请参阅Windows 应用 SDK命名空间) 。 (继承自 VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)	向容器元素分配的数据收集 (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 概述