FrameworkElement.ArrangeOverride(Size) 메서드

protected:
 virtual Size ArrangeOverride(Size finalSize) = ArrangeOverride;

Size ArrangeOverride(Size const& finalSize);

protected virtual Size ArrangeOverride(Size finalSize);

function arrangeOverride(finalSize)

Protected Overridable Function ArrangeOverride (finalSize As Size) As Size

매개 변수

반환

요소가 레이아웃으로 정렬된 후 사용되는 실제 크기입니다.

예제

이 예제에서는 ArrangeOverride를 구현하여 사용자 지정 패널 구현에 대한 "Arrange" 통과 논리를 사용자 지정합니다. 특히 코드의 이러한 측면은 다음과 같습니다.

• 자식을 반복합니다.
• 각 자식에 대해 Height 및 Width가 DesiredSize를 기반으로 하는 Rect를 사용하고 X 및 Y는 패널과 관련된 논리를 기반으로 하는 Rect를 사용하여 Arrange를 호출합니다.
• 크기를 반환합니다(이 경우 이 간단한 패널은 정렬된 Rect 값 측정값을 누적할 때 계산된 크기가 아닌 고정 크기를 반환합니다).

// 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);
}

설명

이 메서드에는 대부분의 FrameworkElement 파생 클래스에 대한 기본 제공 레이아웃을 수행하는 기본 구현이 있습니다. ArrangeOverride는 다른 클래스에 대한 자신의 ArrangeOverride 메서드를 포함하여 내부 레이아웃 논리 또는 사용자 고유의 앱 코드에 의해 Arrange 가 호출될 때마다 Arrange에 대한 동작을 제공합니다. 템플릿 컨트롤을 생성하는 경우 ArrangeOverride 논리는 컨트롤의 특정 "정렬" 패스 레이아웃 논리를 정의합니다.

앱이 실행되면 요소가 레이아웃 프로세스를 통과하는 방법에 대한 일반적인 디자인은 "측정값" 패스와 "정렬" 패스의 두 단계로 나뉩니다. 레이아웃 처리의 "정렬" 패스를 사용자 지정하려는 컨트롤 작성자(또는 패널 작성자)는 ArrangeOverride를 재정의해야 합니다. 구현 패턴은 표시되는 각 자식 개체에 대해 Arrange 를 호출하고 각 자식 개체에 대해 원하는 최종 크기를 finalRect 매개 변수로 전달해야 합니다. Arrange가 호출되지 않으면 자식 개체가 렌더링되지 않습니다.

봉인되지 않은 몇몇 기존 클래스는 이 메서드의 재정의 구현을 제공합니다. 눈에 띄는 항목으로는 StackPanel 및 Grid가 있습니다. 일반적으로 ArrangeOverride의 동작은 레이아웃 컨테이너 자체에 배치되는 사용자 정의 값을 위반하지 않는 finalSize 를 생성합니다. 예를 들어 finalSize는 일반적으로 콘텐츠 영역에 영향을 주는 여백 또는 안쪽 여백 값을 고려하여 컨테이너의 높이 및 너비보다 크지 않습니다. 특히 컨테이너 크기를 초과하는 시나리오가 있는 컨트롤은 더 큰 값을 반환할 수 있지만 해당 컨트롤을 사용하는 모든 사용자는 해당 컨트롤에서 발생하는 클리핑 및 위치 지정 문제를 고려해야 합니다. ArrangeOverride 구현이 각 자식 개체에 대해 Arrange에 전달하는 값은 일반적으로 이전 Measure 호출에 의해 DesiredSize에 설정된 값입니다.

적용 대상

추가 정보

• Arrange(Rect)
• MeasureOverride(Size)
• XAML을 사용하여 레이아웃 정의