FrameworkElement.ArrangeOverride(Size) Método

Definición

Espacio de nombres:

Microsoft.UI.Xaml

Proporciona el comportamiento del paso "Organizar" del diseño. Las clases pueden invalidar este método para definir su propio comportamiento de paso "Organizar".

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

Parámetros

finalSize

Size

Área final dentro del elemento primario que este objeto debe usar para organizarse y sus elementos secundarios.

Devoluciones

Size

Tamaño real que se usa después de organizar el elemento en el diseño.

Ejemplos

En este ejemplo se implementa ArrangeOverride para personalizar la lógica de paso "Organizar" para una implementación de panel personalizada. Tenga en cuenta, en particular, estos aspectos del código:

• Recorre en iteración los elementos secundarios.
• Para cada elemento secundario, llama a Arrange, mediante un rect donde Height y Width se basan en DesiredSize, y X e Y se basan en la lógica específica del panel.
• Devuelve su tamaño (en este caso, este panel simple devuelve un tamaño fijo en lugar de un tamaño calculado al acumular las medidas de valor rect organizadas).

// 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

Este método tiene una implementación predeterminada que realiza el diseño integrado para la mayoría de las clases derivadas de FrameworkElement . ArrangeOverride proporciona el comportamiento de Arrange, cada vez que se llama a Arrange por lógica de diseño interna o por el código de su propia aplicación, incluidos los métodos ArrangeOverride propios para otras clases. Si va a generar un control con plantilla, la lógica ArrangeOverride define la lógica de diseño de paso "Organizar" específica del control.

El diseño general de cómo los elementos pasan por un proceso de diseño cuando la aplicación se ejecuta se divide en dos pasos: un pase "Measure" y, a continuación, un pase "Arrange". Los autores de controles (o autores de paneles) que quieran personalizar el paso "Organizar" del procesamiento de diseño deben invalidar ArrangeOverride. El patrón de implementación debe llamar a Arrange en cada objeto secundario visible y pasar el tamaño deseado final para cada objeto secundario como parámetro finalRect . Si no se llama a Arrange , el objeto secundario no se representa.

Varias clases no selladas existentes proporcionan implementaciones de invalidación de este método. Entre los destacados se incluyen StackPanel y Grid. Normalmente, el comportamiento de ArrangeOverride genera un valor finalSize que no infringe los valores definidos por el usuario que se colocan en el propio contenedor de diseño. Por ejemplo, el valor de finalSize no suele ser mayor que el altoy ancho del contenedor, teniendo en cuenta los valores Margin o Padding que afectan al área de contenido. Los controles que tienen específicamente un escenario para superar el tamaño del contenedor podrían devolver un valor mayor, pero cualquier usuario que use ese control debe tener en cuenta los problemas de recorte y posicionamiento resultantes de él. El valor que pasa una implementación ArrangeOverride a Arrange para cada objeto secundario suele ser el valor establecido en DesiredSize por la llamada a Measure anterior.

Consulte también

• Arrange(Rect)
• MeasureOverride(Size)
• Definir diseños con XAML