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 .

Примеры

В этом примере показано, как использовать Arrange в реализации ArrangeOverride . Основная идея заключается в том, что вы должны запрашивать DesiredSize ко всему, для которого вы пытаетесь вызвать Arrange, чтобы у вас было значение 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 состоит из вызова Measure и вызова Arrange в указанном порядке. Во время вызова Measure система макета определяет требования к размеру элемента с помощью измерения availableSize . Во время вызова Arrange система макета завершает размер и положение ограничивающего прямоугольника элемента.

При первом создании макета он всегда имеет вызов Measure , который выполняется перед упорядочиванием. Однако после первого прохождения макета вызов Arrange может выполняться без меры . Это может произойти при изменении свойства, влияющего только на упорядочивание (например, выравнивание), или при получении родительского объекта Arrange без меры.

Вызов Measure автоматически сделает недействительными все сведения о организации. Обновления макета обычно происходят асинхронно (в то время, определенное системой макета). Элемент может не сразу отражать изменения свойств, влияющие на размер элемента (например , Width).

Обновление макета можно принудительно выполнять с помощью кода приложения, а не полагаться на поведение встроенной системы макета с помощью метода UpdateLayout . Однако это не рекомендуется. Обычно это не требуется и может привести к снижению производительности в случае чрезмерного ее выполнения. Во многих ситуациях, когда вызов UpdateLayout из кода приложения может быть уместным из-за изменений свойств, система макета, вероятно, уже будет обрабатывать обновления. Система макета также имеет оптимизацию для работы с каскадами изменений макета через отношения "родитель-потомок", и вызов UpdateLayout может работать с такой оптимизацией. Тем не менее, возможно, что ситуации макета существуют в более сложных сценариях, где вызов UpdateLayout является лучшим вариантом для устранения проблемы времени или другой проблемы с макетом. Просто используйте его намеренно и экономно.

См. также раздел

• ArrangeOverride(Size)
• MeasureOverride(Size)