UIElement.Arrange(Rect) Método

Definición

Espacio de nombres:

Microsoft.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 en una implementación ArrangeOverride . La idea básica es que debe consultar DesiredSize en cualquier cosa en la que intente llamar 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 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);
}

Comentarios

La Arrange llamada puede llegar 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 Arrange llamada, en ese orden. Durante la Measure llamada, el sistema de diseño determina los requisitos de tamaño de un elemento mediante la availableSize medida. 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 Arrangede . Sin embargo, después del primer paso de diseño, se puede producir una Arrange llamada sin previo Measure . Esto puede ocurrir cuando una propiedad que afecta solo Arrange se cambia (por ejemplo, la alineación) o cuando el elemento primario recibe un Arrange elemento sin Measure.

Una llamada a Measure invalidará automáticamente cualquier Arrange informació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 la llamada UpdateLayout desde el código de la aplicación podría ser adecuada debido a cambios en las propiedades, es probable que el sistema de diseño ya esté procesando 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 las llamadas UpdateLayout pueden funcionar con estas optimizaciones. Sin embargo, es posible que las situaciones de diseño existan en escenarios más complicados en los que llamar 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)