Layout

项目
05/04/2023

本主题介绍 Windows Presentation Foundation (WPF) 布局系统。了解布局计算发生的方式和时间对于在 WPF 中创建用户界面非常重要。

本主题包含以下各节：

元素边界框
布局系统
测量和排列子元素
面板元素和自定义布局行为
布局性能注意事项
子像素渲染和布局舍入
后续步骤

元素边界框

在 WPF 中构思布局时，了解环绕所有元素的边界框非常重要。布局系统使用的每个 FrameworkElement 都可以被视为嵌入到布局中的矩形。 LayoutInformation 类返回元素的布局分配或布局槽的边界。矩形的大小是通过计算可用屏幕空间、任何约束的大小、特定于布局的属性（如边距和填充）以及父 Panel 元素的个别行为来确定的。处理此数据时，布局系统能够计算特定 Panel 的所有子级的位置。请务必记住，调整在父元素（如 Border）上定义的特性的大小会影响其子级。

下图显示了一个简单的布局。

Screenshot that shows a typical grid, no bounding box superimposed.

可以通过使用以下 XAML 实现此布局。

<Grid Name="myGrid" Background="LightSteelBlue" Height="150">
  <Grid.ColumnDefinitions>
    <ColumnDefinition Width="250"/>
  </Grid.ColumnDefinitions>
  <Grid.RowDefinitions>
    <RowDefinition />
    <RowDefinition />
    <RowDefinition />
  </Grid.RowDefinitions>
  <TextBlock Name="txt1" Margin="5" FontSize="16" FontFamily="Verdana" Grid.Column="0" Grid.Row="0">Hello World!</TextBlock>
  <Button Click="getLayoutSlot1" Width="125" Height="25" Grid.Column="0" Grid.Row="1">Show Bounding Box</Button>
  <TextBlock Name="txt2" Grid.Column="1" Grid.Row="2"/>
</Grid>

单个 TextBlock 元素托管在 Grid 中。虽然文本仅填充第一列的左上角，但 TextBlock 的分配空间实际上要大得多。可以使用 GetLayoutSlot 方法检索任何 FrameworkElement 的边界框。下图显示 TextBlock 元素的边界框。

Screenshot that shows that the TextBlock bounding box is now visible.

如黄色矩形所示，TextBlock 元素的分配空间实际上远大于所显示的空间。由于还有其他元素添加到 Grid 中，这种分配可能会收缩或扩展，具体取决于所添加元素的类型和大小。

使用 GetLayoutSlot 方法将 TextBlock 的布局槽转换为 Path。此方法可用于显示元素的边界框。

private void getLayoutSlot1(object sender, System.Windows.RoutedEventArgs e)
{
    RectangleGeometry myRectangleGeometry = new RectangleGeometry();
    myRectangleGeometry.Rect = LayoutInformation.GetLayoutSlot(txt1);
    Path myPath = new Path();
    myPath.Data = myRectangleGeometry;
    myPath.Stroke = Brushes.LightGoldenrodYellow;
    myPath.StrokeThickness = 5;
    Grid.SetColumn(myPath, 0);
    Grid.SetRow(myPath, 0);
    myGrid.Children.Add(myPath);
    txt2.Text = "LayoutSlot is equal to " + LayoutInformation.GetLayoutSlot(txt1).ToString();
}

Private Sub getLayoutSlot1(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim myRectangleGeometry As New RectangleGeometry
    myRectangleGeometry.Rect = LayoutInformation.GetLayoutSlot(txt1)
    Dim myPath As New Path
    myPath.Data = myRectangleGeometry
    myPath.Stroke = Brushes.LightGoldenrodYellow
    myPath.StrokeThickness = 5
    Grid.SetColumn(myPath, 0)
    Grid.SetRow(myPath, 0)
    myGrid.Children.Add(myPath)
    txt2.Text = "LayoutSlot is equal to " + LayoutInformation.GetLayoutSlot(txt1).ToString()
End Sub

布局系统

简单地说，布局是一个递归系统，实现对元素进行大小调整、定位和绘制。更具体地说，布局描述测量和排列 Panel 元素的 Children 集合的成员的过程。布局是一个密集的过程。 Children 集合越大，必须进行的计算次数就越多。根据拥有该集合的 Panel 元素所定义的布局行为，还可能会增加复杂性。相对简单的 Panel（如 Canvas）可以比更复杂的 Panel（如 Grid）具有更好的性能。

每当子 UIElement 改变其位置时，布局系统都可能触发一个新的传递。因此，了解哪些事件会调用布局系统就很重要，因为不必要的调用可能导致应用程序性能变差。下面描述调用布局系统时发生的过程。

子 UIElement 通过首先测量其核心属性来开始布局过程。
计算 FrameworkElement 上定义的大小调整属性，例如 Width、Height 和 Margin。
应用 Panel 特定的逻辑，例如 Dock 方向或堆叠 Orientation。
测量所有子级后排列内容。
在屏幕上绘制 Children 集合。
如果向集合添加了其他 Children，应用了 LayoutTransform，或者调用了 UpdateLayout 方法，则会再次调用该过程。

以下各节更详细地定义了此过程及其调用方式。

测量和排列子元素

布局系统为 Children 集合的每个成员完成两个过程：一个测量过程和一个排列过程。每个子 Panel 都提供自己的 MeasureOverride 和 ArrangeOverride 方法来实现自己的特定布局行为。

在测量过程中，会计算 Children 集合的每个成员。此过程从调用 Measure 方法开始。需要在父 Panel 元素的实现中调用此方法，而不必为要出现的布局显式调用该方法。

首先，计算 UIElement 的本机大小属性，例如 Clip 和 Visibility。这将生成一个名为 constraintSize 的值，该值将传递给 MeasureCore。

其次，处理在 FrameworkElement 上定义的框架属性，这会影响 constraintSize 的值。这些属性通常描述基础 UIElement 的大小调整特性，例如其 Height、Width、Margin 和 Style。其中每个属性都可以更改显示元素所需的空间。然后使用 constraintSize 作为参数调用 MeasureOverride。

注意

Height 和 Width 属性与 ActualHeight 和 ActualWidth 属性有所不同。例如，ActualHeight 属性是基于其他高度输入和布局系统的计算值。该值是由布局系统本身基于实际呈现的传递设置的，因此可能稍微小于属性（例如作为输入更改基础的 Height）的设置值。

因为 ActualHeight 是计算所得的值，所以你应该知道，由于布局系统各种操作的结果，该值可能有多次或递增的报告的更改。布局系统可能会计算子元素所需的测量空间、父元素的约束等。

测量过程的最终目标是让子元素确定其 DesiredSize，这发生在 MeasureCore 调用期间。 Measure 存储 DesiredSize 值，供在内容排列过程中使用。

排列过程从调用 Arrange 方法开始。在排列过程中，父 Panel 元素会生成一个表示子元素边界的矩形。该值将传递给 ArrangeCore 方法进行处理。

ArrangeCore 方法计算子元素的 DesiredSize，并且计算可能影响元素呈现大小的任何其他边距。 ArrangeCore 生成一个 arrangeSize，后者作为参数传递给 Panel 的 ArrangeOverride 方法。 ArrangeOverride 生成子元素的 finalSize。最后，ArrangeCore 方法执行偏移量属性（如边距和对齐）的最终计算，并将子元素放在其布局槽内。子元素不需要（并且通常不）填充整个分配空间。然后将控件返回给父级 Panel，布局过程即告完成。

面板元素和自定义布局行为

WPF 包含一组派生自 Panel 的元素。这些 Panel 元素支持许多复杂的布局。例如，使用 StackPanel 元素可以轻松实现堆叠元素，而使用 Canvas 可实现更复杂和自由流动的布局。

下表汇总了可用的布局 Panel 元素。

面板名称	说明
Canvas	定义一个区域，可在其中通过相对于 Canvas 区域的坐标显式定位子元素。
DockPanel	定义一个区域，可在其中使子元素相互水平或垂直排列。
Grid	定义由列和行组成的灵活的网格区域。
StackPanel	将子元素排列成水平或垂直的一行。
VirtualizingPanel	为虚拟化其子数据集合的 Panel 元素提供一个框架。这是一个抽象类。
WrapPanel	按从左到右的顺序位置定位子元素，在包含框的边缘处将内容切换到下一行。排序顺序是从上到下还是从右到左，取决于 Orientation 属性的值。

对于需要使用任何预定义的 Panel 元素都无法实现的布局的应用程序，可以通过继承 Panel 并替代 MeasureOverride 和 ArrangeOverride 方法来实现自定义布局行为。

布局性能注意事项

布局是一个递归过程。 Children 集合中的每个子元素都会在每次调用布局系统期间得到处理。因此，应避免在不必要时触发布局系统。以下注意事项有助于实现更好的性能。

应注意哪些属性值更改会强制执行布局系统的递归更新。

如果依赖属性的值可能导致布局系统被初始化，则会使用公共标志对该依赖属性进行标记。 AffectsMeasure 和 AffectsArrange 提供了有用的线索，说明哪些属性值更改会强制执行布局系统的递归更新。一般来说，任何可能影响元素边界框大小的属性都应将 AffectsMeasure 标志设置为 True。有关详细信息，请参阅依赖项属性概述。
如果可能，请使用 RenderTransform 而不是 LayoutTransform。

LayoutTransform 是一种影响用户界面 (UI) 内容的非常有用的方式。但是，如果转换效果不需要影响其他元素的位置，则最好改用 RenderTransform，因为 RenderTransform 不会调用布局系统。 LayoutTransform 会应用其转换，并强制执行递归布局更新以获得受影响元素的新位置。
避免对 UpdateLayout 进行不必要的调用。

UpdateLayout 方法会强制执行递归布局更新，通常是不必要的。除非你确定需要进行完整更新，否则请依赖布局系统为你调用此方法。
在处理大型 Children 集合时，请考虑使用 VirtualizingStackPanel 而不是常规的 StackPanel。

通过虚拟化子集合，VirtualizingStackPanel 仅在内存中保留当前位于父级视区内的对象。因此，在大多数情况下，性能得到显著提高。

子像素渲染和布局舍入

WPF 图形系统使用与设备无关的单元来使分辨率和设备独立。每个与设备无关的像素都会随着系统的每英寸点数 (dpi) 设置自动进行缩放。这为 WPF 应用程序提供了不同 dpi 设置的适当缩放，并使应用程序自动感知 dpi。

但是，这种 dpi 无关性可能由于抗锯齿而呈现出不规则的边缘。这些伪影通常被视为模糊或半透明边缘，当边缘的位置落在设备像素的中间而不是设备像素之间时，就可能出现。布局系统提供了一种通过布局倒圆对此进行调整的方法。布局舍入是布局系统在布局传递中舍入任何非整数像素值的情况。

默认情况下禁用布局舍入。若要启用布局舍入，请在任何 FrameworkElement 上将 UseLayoutRounding 属性设置为 true。因为它是一个依赖属性，所以该值将传播到可视化树中的所有子级。若要为整个 UI 启用布局舍入，请在根容器上将 UseLayoutRounding 设置为 true。有关示例，请参见 UseLayoutRounding。

后续步骤

了解元素的测量和排列方式是了解布局的第一步。有关可用 Panel 元素的详细信息，请参阅面板概述。若要更好地了解可能影响布局的各种定位属性，请参阅对齐、边距和填充概述。当你准备好将其全部放在一个轻量级应用程序中时，请参阅演练：我的第一个 WPF 桌面应用程序。

通过