Row QML Type

Posiciona sus hijos en una fila. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• layoutDirection : enumeration
• leftPadding : real
• move : Transition
• padding : real
• populate : Transition
• rightPadding : real
• spacing : real
• topPadding : real

Señales

• positioningComplete()

Métodos

• void forceLayout()

Descripción detallada

Row es un tipo que posiciona sus elementos hijos a lo largo de una única fila. Puede usarse como una forma conveniente de posicionar horizontalmente una serie de elementos sin usar anclas.

Abajo se muestra una Fila que contiene tres rectángulos de varios tamaños:

import QtQuick

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

La Fila posiciona automáticamente estos elementos en una formación horizontal, así:

Si un elemento dentro de una Fila no es visible, o si tiene una anchura o altura de 0, el elemento no se colocará y no será visible dentro de la fila. Además, dado que una Fila posiciona automáticamente a sus elementos hijos horizontalmente, un elemento hijo dentro de una Fila no debería establecer su posición x ni anclarse horizontalmente utilizando las anclas left, right, anchors.horizontalCenter, fill o centerIn. Si necesita realizar estas acciones, considere posicionar los elementos sin utilizar una Fila.

Tenga en cuenta que los elementos en una Fila pueden utilizar la propiedad adjunta Positioner para acceder a más información sobre su posición dentro de la Fila.

Para más información sobre el uso de Filas y otros tipos de posicionadores relacionados, ver Posicionadores de Elementos.

Véase también Column, Grid, Flow, Positioner, RowLayout, y Qt Quick Ejemplos - Posicionadores.

Documentación de Propiedades

add : Transition

Esta propiedad contiene la transición que se ejecutará para los elementos que se añadan a este posicionador. Para un posicionador, esto se aplica a:

• Elementos que son creados o reparentados como hijos del posicionador después de que el posicionador haya sido creado.
• Elementos hijos que cambian su propiedad Item::visible de false a true, y por tanto ahora son visibles.

La transición puede utilizar la propiedad ViewTransition para acceder a más detalles sobre el elemento que se está añadiendo. Consulte la documentación de ViewTransition para obtener más detalles y ejemplos sobre el uso de estas transiciones.

Véase también populate, ViewTransition, y Qt Quick Ejemplos - Posicionadores.

Estas propiedades contienen el relleno alrededor del contenido.

effectiveLayoutDirection : enumeration [read-only]

Esta propiedad contiene la dirección efectiva del diseño de la fila.

Cuando se utiliza la propiedad adjunta LayoutMirroring::enabled para disposiciones locales, la dirección de la disposición visual del posicionador de filas se reflejará. Sin embargo, la propiedad layoutDirection permanecerá inalterada.

Véase también Row::layoutDirection y LayoutMirroring.

layoutDirection : enumeration

Esta propiedad contiene el layoutDirection de la fila.

Valores posibles:

Véase también Grid::layoutDirection y Flow::layoutDirection.

move : Transition

Esta propiedad contiene la transición a ejecutar para los elementos que se han movido dentro del posicionador. Para un posicionador, esto se aplica a:

• Elementos hijos que se mueven al ser desplazados debido a la adición, eliminación o reordenación de otros elementos en el posicionador.
• Elementos secundarios que se reposicionan debido al cambio de tamaño de otros elementos del posicionador.

La transición puede utilizar la propiedad ViewTransition para acceder a más detalles sobre el elemento que se está moviendo. Tenga en cuenta, sin embargo, que para esta transición de movimiento, las listas ViewTransition.targetIndexes y ViewTransition.targetItems sólo se establecen cuando esta transición se desencadena por la adición de otros elementos en el posicionador; en otros casos, estas listas estarán vacías. Consulte la documentación de ViewTransition para obtener más detalles y ejemplos sobre el uso de estas transiciones.

Véase también add, populate, ViewTransition, y Qt Quick Ejemplos - Posicionadores.

populate : Transition

Esta propiedad contiene la transición que se ejecutará para los elementos que forman parte de este posicionador en el momento de su creación. La transición se ejecuta cuando el posicionador se crea por primera vez.

La transición puede utilizar la propiedad ViewTransition para acceder a más detalles sobre el elemento que se está añadiendo. Consulte la documentación de ViewTransition para obtener más detalles y ejemplos sobre el uso de estas transiciones.

Véase también add, ViewTransition, y Qt Quick Ejemplos - Posicionadores.

spacing : real

El espaciado es la cantidad de píxeles que quedan vacíos entre elementos adyacentes. El espaciado por defecto es 0.

Véase también Grid::spacing.

Documentación de la señal

positioningComplete()

Esta señal se emite cuando se ha completado el posicionamiento.

Documentación del método

void forceLayout()

Row suele posicionar a sus hijos una vez por fotograma. Esto significa que dentro de los bloques de script es posible que los hijos subyacentes hayan cambiado, pero que la Fila aún no se haya actualizado en consecuencia.

Este método fuerza a la Fila a responder inmediatamente a cualquier cambio pendiente en sus hijos.

Nota: los métodos en general sólo deben ser llamados después de que el Componente haya finalizado.