UIElement.Arrange(Rect) Methode

Definition

Namespace:

Microsoft.UI.Xaml

Positioniert untergeordnete Objekte und bestimmt eine Größe für ein UIElement. Übergeordnete Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Elemente implementieren, sollten diese Methode aus ihren Layoutüberschreibungsimplementierungen aufrufen, um eine rekursive Layoutaktualisierung zu bilden.

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

finalRect

Rect

Die endgültige Größe, die das übergeordnete Element für das untergeordnete Element im Layout berechnet, bereitgestellt als Rect-Wert .

Beispiele

In diesem Beispiel wird gezeigt, wie Sie in einer ArrangeOverride-Implementierung verwenden Arrange würden. Die Grundidee ist, dass Sie DesiredSize für alles abfragen sollten, was Sie aufrufen Arrange möchten, sodass Sie einen Wert für finalRecthaben, es sei denn, Ihre Layoutimplementierung verfügt über einen bestimmten Entwurf, der die gewünschte Größe ändert oder ignoriert, bevor sie als finalRectübergeben wird.

// 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 möglicherweise eine ArrangeOverride-Implementierung dieser spezifischen Klasse. Andernfalls weisen die meisten FrameworkElement-Klassen ein implizites Standardlayoutverhalten für auf 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 Arrange-Aufrufs definiert das Layoutsystem die Größe und Position des Begrenzungsrahmens eines Elements.

Wenn ein Layout zum ersten Mal erstellt wird, verfügt es immer über einen Measure-Aufruf , der vor Arrangeerfolgt. Nach dem ersten Layoutdurchlauf kann jedoch ein Arrange Aufruf erfolgen, ohne dass ein vorangegangen wird Measure . Dies kann passieren, wenn eine Eigenschaft, die sich nur Arrange auswirkt, geändert wird (z. B. Ausrichtung), oder wenn das übergeordnete Element einen Arrange ohne Measureempfängt.

Bei einem Measure-Aufruf werden alle Arrange Informationen automatisch ungültig. Layoutupdates 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 Elementdimensionierung auswirken (z. B. Breite).

Layoutupdates können durch App-Code erzwungen werden, anstatt sich mit der UpdateLayout-Methode auf das integrierte Layoutsystemverhalten zu verlassen. Dies wird jedoch nicht empfohlen. Es ist in der Regel unnötig und kann bei Überlastung zu einer schlechten Leistung führen. In vielen Situationen, in denen das Aufrufen UpdateLayout von App-Code aufgrund von Eigenschaftenänderungen geeignet sein kann, verarbeitet das Layoutsystem wahrscheinlich bereits Updates. Das Layoutsystem verfügt auch über Optimierungen für den Umgang mit Kaskaden von Layoutänderungen über über-untergeordnete Beziehungen, und das Aufrufen UpdateLayout kann gegen solche Optimierungen funktionieren. Dennoch ist es möglich, dass Layoutsituationen in komplizierteren Szenarien auftreten, in denen das Aufrufen UpdateLayout die beste Option zum Beheben eines Zeitsteuerungsproblems oder eines anderen Layoutproblems ist. Verwenden Sie es einfach bewusst und sparsam.

Weitere Informationen

• ArrangeOverride(Size)
• MeasureOverride(Size)