FrameworkElement.ArrangeOverride(Size) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce il comportamento per il passaggio di layout "Arrange". Le classi possono eseguire l'override di questo metodo per definire il proprio comportamento di passaggio "Arrange".

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

finalSize: Size

Area finale all'interno dell'elemento padre che questo oggetto deve usare per disporre se stesso e i relativi elementi figlio.

Restituisce

Size

Dimensione effettiva usata dopo che l'elemento è disposto nel layout.

Esempio

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

Scorre i bambini.
Per ogni figlio, chiama Arrange, usando un oggetto Rect in cui Height e Width sono basati su DesiredSize e X e Y si basano sulla logica specifica del pannello.
Restituisce le dimensioni (in questo caso, questo semplice pannello restituisce una dimensione fissa anziché una dimensione calcolata per accumulare le misurazioni dei valori rect disposti).

// 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 modello, la logica ArrangeOverride definisce la logica di layout di pass "Arrange" specifica del controllo.

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

Diverse classi non sigillate esistenti forniscono implementazioni di override di questo metodo. Quelli principali includono StackPanel e Grid. In genere, il comportamento di ArrangeOverride produce un oggetto finalSize che non viola i valori definiti dall'utente che vengono inseriti 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 che un'implementazione di ArrangeOverride passa a Arrange per ogni oggetto figlio è in genere il valore impostato in DesiredSize dalla chiamata Di misura precedente.

Si applica a

Condividi tramite