FrameworkElement.ArrangeOverride(Size) Metodo

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

Parametri

Valori restituiti

Dimensioni effettive utilizzate dopo che l'elemento è disposto nel layout.

Esempio

Questo esempio implementa ArrangeOverride per personalizzare la logica di passaggio "Arrange" per un'implementazione del pannello personalizzata. Si noti in particolare questi aspetti del codice:

• Scorre i bambini.
• Per ogni elemento figlio, chiama Arrange, usando un controllo Rect in cui Height e Width sono basati su DesiredSize e X e Y sono basati sulla logica specifica del pannello.
• Restituisce le dimensioni (in questo caso, questo pannello semplice restituisce una dimensione fissa anziché una dimensione calcolata per accumulare le misurazioni del valore Rect disposto).

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

Commenti

Questo metodo ha un'implementazione predefinita che esegue il layout predefinito per la maggior parte delle classi derivate di FrameworkElement . ArrangeOverride fornisce il comportamento per Arrange, ogni volta che Arrange viene chiamato dalla logica di layout interno o dal codice dell'app, inclusi i metodi ArrangeOverride personalizzati per altre classi. Se si produce un controllo basato su modelli, la logica ArrangeOverride definisce la logica di layout del pass "Arrange" specifica del controllo.

La progettazione generale del modo in cui gli elementi passano attraverso un processo di layout quando l'app viene eseguita è divisa in due passaggi: un passaggio "Misura" e quindi un passaggio "Disponi". Gli autori di controlli (o autori di pannelli) che desiderano personalizzare il passaggio "Disponi" dell'elaborazione del layout devono eseguire l'override di ArrangeOverride. Il modello di implementazione deve chiamare Arrange per ogni oggetto figlio visibile e passare le dimensioni finali desiderate per ogni oggetto figlio come parametro finalRect . Se Arrange non viene chiamato, il rendering dell'oggetto figlio non viene eseguito.

Diverse classi non sealed esistenti forniscono implementazioni di override di questo metodo. Quelli prominenti includono StackPanel e Grid. In genere, il comportamento di ArrangeOverride produce un oggetto finalSize che non viola i valori definiti dall'utente posizionati nel contenitore di layout stesso. Ad esempio, finalSize non è in genere più grande rispetto all'altezza e alla larghezza del contenitore, tenendo conto dei valori Margin o Padding che influiscono sull'area del contenuto. I controlli che in particolare hanno uno scenario per superare le dimensioni del contenitore potrebbero restituire un valore maggiore, ma chiunque usi tale controllo deve tenere conto dei problemi di ritaglio e posizionamento che ne derivano. Il valore passato da un'implementazione ArrangeOverride a Arrange per ogni oggetto figlio è in genere il valore impostato in DesiredSize dalla chiamata di Measure precedente.

Vedi anche

• Arrange(Rect)
• MeasureOverride(Size)
• Definire layout con XAML