UIElement.Arrange(Rect) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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)
매개 변수
예제
이 예제에서는 ArrangeOverride 구현 내에서 를 사용하는 Arrange
방법을 보여줍니다. 기본 개념은 레이아웃 구현에서 원하는 크기를 변경하거나 무시한 후 로 전달하지 않는 한 에 대한 finalRect
값을 갖도록 호출 Arrange
하려는 모든 항목에 대해 DesiredSize를 쿼리해야 한다는 것입니다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 UI의 초기 레이아웃 위치 계산은 측정값 호출과 호출 순서로 Arrange
구성됩니다. 호출 중에 Measure
레이아웃 시스템은 측정값을 사용하여 availableSize
요소의 크기 요구 사항을 결정합니다. 정렬 호출 중에 레이아웃 시스템은 요소 경계 상자의 크기와 위치를 마무리합니다.
레이아웃이 처음 생성되면 항상 이전에 Arrange
발생하는 Measure 호출이 있습니다. 그러나 첫 번째 레이아웃이 통과한 후에는 Arrange
앞에 없으면 호출이 Measure
발생할 수 있습니다. 이는 에만 Arrange
영향을 주는 속성이 변경되거나(예: 맞춤) 부모가 없이 Measure
를 수신할 Arrange
때 발생할 수 있습니다.
측정값 호출은 모든 Arrange
정보를 자동으로 무효화합니다. 레이아웃 업데이트는 일반적으로 비동기적으로 발생합니다(레이아웃 시스템에 의해 결정되는 시간에). 요소 크기 조정(예: Width)에 영향을 주는 속성의 변경 내용을 요소에 즉시 반영하지 않을 수 있습니다.
UpdateLayout 메서드를 사용하여 기본 제공 레이아웃 시스템 동작에 의존하지 않고 앱 코드에서 레이아웃 업데이트를 강제 적용할 수 있습니다. 그러나 권장되지는 않습니다. 일반적으로 불필요하며 과도하게 사용하면 성능이 저하될 수 있습니다. 속성 변경으로 인해 앱 코드에서 를 호출 UpdateLayout
하는 것이 적절할 수 있는 많은 상황에서 레이아웃 시스템은 이미 업데이트를 처리하고 있을 것입니다. 또한 레이아웃 시스템에는 부모-자식 관계를 통해 연속된 레이아웃 변경 내용을 처리하기 위한 최적화가 있으며 호출 UpdateLayout
은 이러한 최적화에 대해 작동할 수 있습니다. 그럼에도 불구하고 호출 UpdateLayout
이 타이밍 문제 또는 다른 레이아웃 문제를 해결하는 데 가장 적합한 옵션인 더 복잡한 시나리오에서 레이아웃 상황이 존재할 수 있습니다. 의도적으로 그리고 드물게 사용하세요.