UIElement.Arrange(Rect) Método

Definición

Espacio de nombres:

Windows.UI.Xaml

Coloca los objetos secundarios y determina un tamaño para un UIElement. Los objetos primarios que implementan el diseño personalizado para sus elementos secundarios deben llamar a este método desde sus implementaciones de invalidación de diseño para formar una actualización de diseño recursiva.

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)

Parámetros

finalRect

Rect

Tamaño final que el elemento primario calcula para el elemento secundario en el diseño, proporcionado como un valor rect .

Ejemplos

En este ejemplo se muestra cómo usaría Arrange dentro de una implementación arrangeOverride . La idea básica es que debe consultar DesiredSize en cualquier cosa en la que intente llamar a Arrange para que tenga un valor para finalRect, a menos que la implementación del diseño tenga algún diseño específico que modifique o o ignore el tamaño deseado antes de pasarlo como finalRect.

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

'Second arrange all children and return final size of panel 
Protected Overrides Function ArrangeOverride(ByVal finalSize As Size) As Size
    'Get the collection of children 
    Dim mychildren As UIElementCollection = Children
    'Get total number of children 
    Dim count As Integer = mychildren.Count
    'Arrange children 
    'only allowing 9 children in this panel. More children will get a 0x0 layout slot. 
    Dim i As Integer
    For i = 0 To 8
        'Get (left, top) origin point for the element in the 3x3 block 
        Dim cellOrigin As Point = 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. 
        Dim dw As Double = mychildren(i).DesiredSize.Width
        Dim dh As Double = mychildren(i).DesiredSize.Height
        mychildren(i).Arrange(New Rect(cellOrigin.X, cellOrigin.Y, dw, dh))
    Next
    For i = 9 To count - 1
        'Give the remaining children a 0x0 layout slot 
        mychildren(i).Arrange(New Rect(0, 0, 0, 0))
    Next
    'Return final size of the panel 
    Return New Size(300, 300)
End Function
'Calculate point origin of the Block you are in 
Protected Function GetOrigin(ByVal blockNum As Integer, ByVal blocksPerRow As Integer, ByVal itemSize As Size) As Point
    'Get row number (zero-based) 
    Dim row As Integer = CInt(Math.Floor(blockNum / blocksPerRow))
    'Get column number (zero-based) 
    Dim column As Integer = blockNum - blocksPerRow * row
    'Calculate origin 
    Dim origin As New Point(itemSize.Width * column, itemSize.Height * row)
    Return origin
End Function

Comentarios

La llamada Arrange llega potencialmente a una implementación ArrangeOverride de esa clase específica. De lo contrario, la mayoría de las clases FrameworkElement tienen un comportamiento de diseño predeterminado implícito para Arrange.

El cálculo del posicionamiento de diseño inicial en una interfaz de usuario XAML consta de una llamada Measure y una llamada Arrange, en ese orden. Durante la llamada a Measure , el sistema de diseño determina los requisitos de tamaño de un elemento mediante la medida availableSize . Durante la llamada Arrange, el sistema de diseño finaliza el tamaño y la posición del cuadro de límite de un elemento.

Cuando se genera un diseño por primera vez, siempre tiene una llamada Measure que se produce antes de Organizar. Sin embargo, después del primer pase de diseño, se puede producir una llamada Arrange sin una medida anterior. Esto puede ocurrir cuando se cambia una propiedad que afecta solo a Arrange (por ejemplo, la alineación) o cuando el elemento primario recibe un objeto Arrange sin una medida.

Una llamada a Measure invalidará automáticamente cualquier información de Organización. Por lo general, las actualizaciones de diseño se producen de forma asincrónica (en un momento determinado por el sistema de diseño). Es posible que un elemento no refleje inmediatamente los cambios en las propiedades que afectan al ajuste de tamaño del elemento (como Width).

El código de la aplicación puede forzar las actualizaciones de diseño en lugar de confiar en el comportamiento del sistema de diseño integrado mediante el método UpdateLayout . Sin embargo, no se recomienda. Normalmente no es necesario y puede provocar un rendimiento deficiente si se usa demasiado. En muchas situaciones en las que llamar a UpdateLayout desde el código de la aplicación podría ser adecuado debido a cambios en las propiedades, es probable que el sistema de diseño ya esté procesando las actualizaciones. El sistema de diseño también tiene optimizaciones para tratar con cascadas de cambios de diseño a través de relaciones de elementos primarios y secundarios, y llamar a UpdateLayout puede funcionar con estas optimizaciones. Sin embargo, es posible que las situaciones de diseño existan en escenarios más complicados en los que llamar a UpdateLayout es la mejor opción para resolver un problema de tiempo u otro problema con el diseño. Sólo úselo deliberadamente y con moderación.

Consulte también

• ArrangeOverride(Size)
• MeasureOverride(Size)