UIElement.Arrange(Rect) Метод

Определение

Пространство имен:

Microsoft.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);
}

Комментарии

Вызов Arrange потенциально достигает реализации ArrangeOverride этого конкретного класса. В противном случае большинство классов FrameworkElement имеют неявное поведение макета по умолчанию для Arrange.

Вычисление начального размещения макета в пользовательском интерфейсе XAML состоит из вызова Measure и Arrange вызова в указанном порядке. Measure Во время вызова система макета определяет требования к размеру элемента с помощью availableSize измерения. Во время вызова Arrange система макета завершает размер и положение ограничивающего прямоугольника элемента.

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

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

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

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

• ArrangeOverride(Size)
• MeasureOverride(Size)