Stackpanel：高度 vs ActualHeight vs ExtentHeight vs ViewportHeight vs DesiredSize vs RenderSize

Question

我想知道我的 StackPanel 所有项目的高度。

两者之间有什么区别：

• 高度 - 获取或设置元素的建议高度。
• ActualHeight - 获取渲染高度这个元素。 （只读）
• ExtentHeight- 获取包含范围垂直尺寸的值。 （只读）
• ViewportHeight- 获取包含内容视口的垂直尺寸的值。 （只读）
• DesiredSize - 获取该元素在布局过程的测量过程中计算的大小。 （只读）
• RenderSize - 获取（或设置，但请参阅备注）此元素的最终渲染大小。

---

来自 MSDN：

高度
获取或设置元素的建议高度。

属性值：Double - 元素的高度，采用与设备无关的单位（每个单位 1/96 英寸）。

元素的高度，采用与设备无关的单位（每单位 1/96 英寸）。

 

实际高度（只读)
获取此元素的渲染高度。

属性值：Double - 元素的高度，以与设备无关的单位表示的值（每单位 1/96 英寸）。

此属性是基于其他高度输入和布局系统的计算值。该值是由布局系统本身根据实际渲染通道设置的，因此可能会稍微落后于属性的设置值，例如 高度，这是输入更改的基础。

由于 ActualHeight 是一个计算值，因此您应该注意，由于布局系统的各种操作，可能会对其进行多次或增量报告的更改。布局系统可能正在计算子元素所需的度量空间、父元素的约束等等。

 

范围高度 ( 只读）
获取包含范围的垂直大小的值。

属性高度：Double - 表示范围垂直大小的 Double。

返回的值在设备独立像素中进行了描述。

 

ViewportHeight ( 只读）
获取一个包含内容视口的垂直尺寸的值。

属性值：Double - 表示内容视口的垂直尺寸的 Double。

返回的值在设备独立像素中进行了描述。

 

所需大小（只读)
获取该元素在布局过程的测量过程中计算的大小。

属性值：Size - 计算出的大小，它将成为排列通道所需的大小。

仅当 IsMeasureValid 属性的值为 true 时，此属性返回的值才是有效的测量值。

当您实现布局行为覆盖（例如 ArrangeOverride、MeasureOverride 或 OnRender）时，通常会检查 DesiredSize 作为测量因素之一（在 OnRender 情况下，您可能会检查 RenderSize，但这取决于您的实现）。根据具体情况，您的实现逻辑可能会完全遵守 DesiredSize，可能会应用对 DesiredSize 的约束，并且此类约束还可能会更改父元素或子元素的其他特征。例如，支持可滚动区域的控件（但选择不从已启用可滚动区域的 WPF 框架级控件派生）可以将可用大小与 DesiredSize 进行比较。然后，该控件可以设置一个内部状态，以在该控件的 UI 中启用滚动条。或者，在某些情况下，DesiredSize 也可能被忽略。

 

渲染大小 获取该元素的最终渲染大小。

属性值：Size - 此元素的渲染大小。

此属性可用于检查布局系统覆盖（例如 OnRender 或 GetLayoutClip）中适用的渲染大小。

更常见的场景是使用类处理程序重写或 OnRenderSizeChanged 事件处理 SizeChanged 事件。

---

就我而言，我想知道 StackPanel 中所有项目的所需高度。

换句话说：我想知道 StackPanel 中所有项目的高度（在绘制之前），如果它们溢出面板，我将

• 删除
• 缩小
• 比例
• 调整

项目以确保它们适合 StackPanel 。

这意味着我可能想在调整大小事件期间获得所需高度（ExtentHeight？DesiredSize？）（大小更改？LayoutUpdated ) - 在任何绘图发生之前（因此速度更快）。

大多数这些属性返回零；显然，我不知道这些属性的含义，也没有在文档中进行解释。

Answer 1

如您所知，StackPanel 是一个 [Panel] 对象。每个面板通过两种方法与其子面板进行通信，以确定最终的尺寸和位置。
第一个方法是 MeasureOverride，第二个方法是 ArrangeOverride。

MeasureOveride 询问每个子项所需的大小以及给定的可用空间量。
ArrangeOverride 在测量完成后排列子项。

让我们创建一个堆栈面板：

public class AnotherStackPanel : Panel
{
    public static readonly DependencyProperty OrientationProperty =
        DependencyProperty.Register(“Orientation”, typeof(Orientation),
        typeof(SimpleStackPanel), new FrameworkPropertyMetadata(
        Orientation.Vertical, FrameworkPropertyMetadataOptions.AffectsMeasure));

    public Orientation Orientation
    {
        get { return (Orientation)GetValue(OrientationProperty); }
        set { SetValue(OrientationProperty, value); }
    }

    protected override Size MeasureOverride(Size availableSize)
    {
        Size desiredSize = new Size();

        if (Orientation == Orientation.Vertical)
            availableSize.Height = Double.PositiveInfinity;
        else
            availableSize.Width = Double.PositiveInfinity;
        foreach (UIElement child in this.Children)
        {
            if (child != null)
            {
                child.Measure(availableSize);

                if (Orientation == Orientation.Vertical)
                {
                    desiredSize.Width = Math.Max(desiredSize.Width,
                    child.DesiredSize.Width);
                    desiredSize.Height += child.DesiredSize.Height;
                }
                else
                {
                    desiredSize.Height = Math.Max(desiredSize.Height,
                    child.DesiredSize.Height);
                    desiredSize.Width += child.DesiredSize.Width;
                }
            }
        }
        return desiredSize;
    }

    protected override Size ArrangeOverride(Size finalSize)
    {
        double offset = 0;
        foreach (UIElement child in this.Children)
        {
            if (child != null)
            {
                if (Orientation == Orientation.Vertical)
                {               
                    child.Arrange(new Rect(0, offset, finalSize.Width,
                    child.DesiredSize.Height));                 
                    offset += child.DesiredSize.Height;
                }
                else
                {                   
                    child.Arrange(new Rect(offset, 0, child.DesiredSize.Width,
                    finalSize.Height));
                    offset += child.DesiredSize.Width;
                }
            }
        }
        return finalSize;
    }
}

• DesiredSize（大小
  由 MeasureOverride 返回）是总和
  子项大小的方向
  StackPanel 和最大的尺寸
  另一个方向的孩子。

• RenderSize代表最终的
  布局后 StackPanel 的大小
  完成。

• ActualHeight 与
  RenderSize.Height。

要依赖这些属性，您应该仅在 LayoutUpdated 事件。

• 对于 ViewPortHeight 外观
  此处
• 为ExtentHeight 看看
  这里

Answer 2

上面的答案是正确的，除了 RenderSize 和 ActualHeight 可以具有暂时不同的值。 RenderSize 在 OnRender 之前设置，而 ActualHeight 在 WPF 完成该控件的布局和渲染处理后设置。最后，LayoutUpdated 被引发。

因此，RenderSize 可以在 OnRender 中使用，但 ActualHeight 仍将具有布局开始之前的旧值。

该序列如下所示：

MeasureOverride() => sets DesiredSize
ArrangeOverride() => sets RenderSize
OnRender()

WPF 可能会多次执行该序列（递归）。一旦一切都解决了，就会执行以下操作：

ActualHeight = RenderSize.Height

在第一个布局完成后，可以随时访问 ActualHeight（！），除了在测量、排列和渲染的布局过程本身期间。 WPF 确保所有代码在布局处理运行之前完成。