FrameworkElement.ArrangeOverride(Size) Methode

Definition

Stellt das Verhalten für den Layoutdurchlauf "Anordnen" bereit. Klassen können diese Methode überschreiben, um ihr eigenes Passverhalten "Arrange" zu definieren.

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

Parameter

finalSize
Size

Der letzte Bereich innerhalb des übergeordneten Objekts, den dieses Objekt verwenden sollte, um sich selbst und seine untergeordneten Elemente anzuordnen.

Gibt zurück

Die tatsächliche Größe, die verwendet wird, nachdem das Element im Layout angeordnet ist.

Beispiele

In diesem Beispiel wird ArrangeOverride implementiert, um die Passlogik "Anordnen" für eine benutzerdefinierte Panelimplementierung anzupassen. Beachten Sie insbesondere die folgenden Aspekte des Codes:

  • Iteriert kinder.
  • Ruft für jedes untergeordnete Element Anordnenauf, wobei Höhe und Breite auf DesiredSize basieren, und X und Y auf logik basieren, die für den Bereich spezifisch ist.
  • Gibt seine Größe zurück (in diesem Fall gibt dieser einfache Bereich eine feste Größe und nicht eine Größe zurück, die beim Akkumulieren der angeordneten Rect-Wert-Messungen berechnet 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

Diese Methode verfügt über eine Standardimplementierung, die ein integriertes Layout für die meisten von FrameworkElement abgeleiteten Klassen ausführt. ArrangeOverride stellt das Verhalten für Arrange bereit, wenn Arrange entweder durch die interne Layoutlogik oder den Code Ihrer eigenen App aufgerufen wird, einschließlich aller Eigenen ArrangeOverride-Methoden für andere Klassen. Wenn Sie ein vorlagenbasiertes Steuerelement erstellen, definiert die ArrangeOverride-Logik die spezifische Passlayoutlogik "Anordnen" Ihres Steuerelements.

Der allgemeine Entwurf, wie Elemente einen Layoutprozess durchlaufen, wenn Ihre App ausgeführt wird, gliedert sich in zwei Schritte: einen "Measure"-Durchlauf und dann einen Durchgang "Anordnen". Steuerelementautoren (oder Panelautoren), die den Durchgang "Anordnen" der Layoutverarbeitung anpassen möchten, sollten ArrangeOverride überschreiben. Das Implementierungsmuster sollte Arrange für jedes sichtbare untergeordnete Objekt aufrufen und die endgültige gewünschte Größe für jedes untergeordnete Objekt als finalRect-Parameter übergeben. Wenn Arrange nicht aufgerufen wird, wird das untergeordnete Objekt nicht gerendert.

Mehrere vorhandene nicht versiegelte Klassen bieten Überschreibungsimplementierungen dieser Methode. Zu den prominenten gehören StackPanel und Grid. In der Regel erzeugt das Verhalten von ArrangeOverride eine finalSize , die keine benutzerdefinierten Werte verletzt, die im Layoutcontainer selbst platziert werden. Beispielsweise ist finalSize in der Regel nicht größer als die Höhe und Breite des Containers, wobei die Werte "Margin" oder "Padding" berücksichtigt werden, die sich auf den Inhaltsbereich auswirken. Steuerelemente, die speziell ein Szenario für die Überschreitung der Containergröße aufweisen, können einen größeren Wert zurückgeben, aber jeder, der dieses Steuerelement verwendet, muss die daraus resultierenden Probleme beim Ausschneiden und Positionieren berücksichtigen. Der Wert, den eine ArrangeOverride-Implementierung für jedes untergeordnete Objekt an Arrange übergibt, ist im Allgemeinen der Wert, der in DesiredSize durch den vorherigen Measure-Aufruf festgelegt wird.

Gilt für:

Weitere Informationen