UIElement.Arrange(Rect) 方法

定义

命名空间:

Windows.UI.Xaml

定位子对象并确定 UIElement 的大小。 为其子元素实现自定义布局的父对象应从其布局重写实现中调用此方法，以形成递归布局更新。

public:
 virtual void Arrange(Rect finalRect) = Arrange;

void Arrange(Rect const& finalRect);

public void Arrange(Rect finalRect);

function arrange(finalRect)

Public Sub Arrange (finalRect As Rect)

参数

finalRect

Rect

父级为布局中的子级计算的最终大小，以 Rect 值的形式提供。

示例

此示例演示如何在 ArrangeOverride 实现中使用 Arrange。 基本思路是，应查询要调用 Arrange 的任何内容 上的 DesiredSize ，以便具有 finalRect 的值，除非布局实现具有一些特定设计，在将其作为 finalRect 传递之前更改或忽略所需大小。

// Second arrange all children and return final size of panel
protected override Size ArrangeOverride(Size finalSize)
{
    // Get the collection of children
    UIElementCollection mychildren = Children;

    // Get total number of children
    int count = mychildren.Count;

    // Arrange children
    // We're only allowing 9 children in this panel.  More children will get a 0x0 layout slot.
    int i;
    for (i = 0; i < 9; i++)
    {

        // Get (left, top) origin point for the element in the 3x3 block
        Point cellOrigin = GetOrigin(i, 3, new Size(100, 100));

        // Arrange child
        // Get desired height and width. This will not be larger than 100x100 as set in MeasureOverride.
        double dw = mychildren[i].DesiredSize.Width;
        double dh = mychildren[i].DesiredSize.Height;

        mychildren[i].Arrange(new Rect(cellOrigin.X, cellOrigin.Y, dw, dh));

    }

    // Give the remaining children a 0x0 layout slot
    for (i = 9; i < count; i++)
    {
        mychildren[i].Arrange(new Rect(0, 0, 0, 0));
    }


    // Return final size of the panel
    return new Size(300, 300);
}

'Second arrange all children and return final size of panel 
Protected Overrides Function ArrangeOverride(ByVal finalSize As Size) As Size
    'Get the collection of children 
    Dim mychildren As UIElementCollection = Children
    'Get total number of children 
    Dim count As Integer = mychildren.Count
    'Arrange children 
    'only allowing 9 children in this panel. More children will get a 0x0 layout slot. 
    Dim i As Integer
    For i = 0 To 8
        'Get (left, top) origin point for the element in the 3x3 block 
        Dim cellOrigin As Point = GetOrigin(i, 3, New Size(100, 100))
        'Arrange child 
        'Get desired height and width. This will not be larger than 100x100 as set in MeasureOverride. 
        Dim dw As Double = mychildren(i).DesiredSize.Width
        Dim dh As Double = mychildren(i).DesiredSize.Height
        mychildren(i).Arrange(New Rect(cellOrigin.X, cellOrigin.Y, dw, dh))
    Next
    For i = 9 To count - 1
        'Give the remaining children a 0x0 layout slot 
        mychildren(i).Arrange(New Rect(0, 0, 0, 0))
    Next
    'Return final size of the panel 
    Return New Size(300, 300)
End Function
'Calculate point origin of the Block you are in 
Protected Function GetOrigin(ByVal blockNum As Integer, ByVal blocksPerRow As Integer, ByVal itemSize As Size) As Point
    'Get row number (zero-based) 
    Dim row As Integer = CInt(Math.Floor(blockNum / blocksPerRow))
    'Get column number (zero-based) 
    Dim column As Integer = blockNum - blocksPerRow * row
    'Calculate origin 
    Dim origin As New Point(itemSize.Width * column, itemSize.Height * row)
    Return origin
End Function

注解

Arrange 调用可能会到达该特定类的 ArrangeOverride 实现。 否则，大多数 FrameworkElement 类具有 Arrange 的隐式默认布局行为。

XAML UI 中初始布局定位的计算包括 一个 Measure 调用和一个 Arrange 调用（按该顺序）。 在 Measure 调用期间，布局系统使用 availableSize 度量来确定元素的大小要求。 在 Arrange 调用期间，布局系统会确定元素边界框的大小和位置。

首次生成布局时，它始终具有在 Arrange 之前发生的 Measure 调用。 但是，在第一次布局传递后，在前面没有 Measure 的情况下，可能会发生 Arrange 调用。 当仅影响 Arrange 的属性 (更改（例如对齐) ）或父级收到不含 Measure 的 Arrange 时，可能会发生这种情况。

Measure 调用将自动使任何排列信息失效。 布局更新通常在布局系统) 确定的时间异步 (发生。 元素可能不会立即反映影响元素大小调整 (的属性更改，例如 Width) 。

布局更新可由应用代码强制执行，而不是使用 UpdateLayout 方法依赖于内置布局系统行为。 但是，不建议这样做。 这通常是不必要的，如果过度使用，可能会导致性能不佳。 在许多情况下，由于属性更改，可能适合从应用代码调用 UpdateLayout ，布局系统可能已在处理更新。 布局系统还针对通过父子关系处理布局更改的级联进行了优化，并且调用 UpdateLayout 可以应对此类优化。 不过，布局情况可能存在于更复杂的方案中，调用 UpdateLayout 是解决计时问题或其他布局问题的最佳选择。 只是故意和谨慎地使用它。

另请参阅

• ArrangeOverride(Size)
• MeasureOverride(Size)