UIElement.Arrange(Rect) Methode

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)

Parameter

Beispiele

In diesem Beispiel wird gezeigt, wie Sie in einer ArrangeOverride-Implementierung verwenden Arrange würden. Die Grundidee ist, dass Sie "DesiredSize " auf alles abfragen sollten, was Sie aufrufen Arrange möchten, damit Sie über einen Wert verfügen finalRect, es sei denn, ihre Layoutimplementierung hat ein bestimmtes Design, das die gewünschte Größe ändert oder ignoriert, bevor Sie sie finalRectals übergeben.

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

Hinweise

Der Arrange Aufruf erreicht potenziell eine ArrangeOverride-Implementierung dieser bestimmten Klasse. Andernfalls weisen die meisten FrameworkElement-Klassen ein implizites Standardlayoutverhalten für Arrange.

Die Berechnung der anfänglichen Layoutpositionierung in einer XAML-Benutzeroberfläche besteht aus einem Measure-Aufruf und einem Arrange Aufruf in dieser Reihenfolge. Während des Measure Aufrufs bestimmt das Layoutsystem die Größenanforderungen eines Elements mithilfe der availableSize Messung. Während des Anordnungsaufrufs schließt das Layoutsystem die Größe und Position des umgebenden Felds eines Elements ab.

Wenn ein Layout zum ersten Mal erstellt wird, verfügt es immer über einen Measure-Aufruf , der vorher Arrangeerfolgt. Nach dem ersten Layoutdurchlauf kann ein Arrange Aufruf jedoch ohne Measure vorangehenden Vorgang erfolgen. Dies kann passieren, wenn eine Eigenschaft, die sich nur Arrange auf die Änderung auswirkt (z. B. Ausrichtung), oder wenn das übergeordnete Element eine Arrange ohne Eine Measureerhält.

Bei einem Measure-Aufruf werden automatisch alle Arrange Informationen ungültig. Layoutaktualisierungen erfolgen in der Regel asynchron (zu einem zeitpunkt, der vom Layoutsystem bestimmt wird). Ein Element spiegelt möglicherweise nicht sofort Änderungen an Eigenschaften wider, die sich auf die Größenanpassung von Elementen auswirken (z. B. Breite).

Layoutupdates können durch App-Code erzwungen werden, anstatt sich auf das integrierte Layoutsystemverhalten mithilfe der UpdateLayout-Methode zu verlassen. Dies wird jedoch nicht empfohlen. Es ist in der Regel unnötig und kann eine schlechte Leistung verursachen, wenn sie überlastet ist. In vielen Situationen, in denen das Aufrufen UpdateLayout von App-Code aufgrund von Änderungen an Eigenschaften geeignet sein könnte, verarbeitet das Layoutsystem wahrscheinlich bereits Updates. Das Layoutsystem verfügt auch über Optimierungen für den Umgang mit Übergängen von Layoutänderungen durch Beziehungen zwischen übergeordneten und untergeordneten Elementen, und das Aufrufen UpdateLayout kann gegen solche Optimierungen funktionieren. Dennoch ist es möglich, dass Layoutsituationen in komplizierteren Szenarien vorhanden sind, in denen das Aufrufen UpdateLayout die beste Option zum Beheben eines Timing-Problems oder eines anderen Problems mit layout ist. Verwenden Sie es einfach bewusst und sparsam.

Weitere Informationen

• ArrangeOverride(Size)
• MeasureOverride(Size)