Flow QML Type

Posiciona sus hijos uno al lado del otro, envolviéndolos si es necesario. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• flow : 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

El elemento Flow posiciona sus elementos hijos como palabras en una página, envolviéndolos para crear filas o columnas de elementos.

A continuación se muestra un flujo que contiene varios elementos Text:

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

El elemento Flow coloca automáticamente los elementos Text hijos uno al lado del otro, envolviéndolos según sea necesario:

Si un elemento dentro de un flujo no es visible, o si tiene una anchura o altura de 0, el elemento no se colocará y no será visible dentro del flujo. Además, dado que un Flujo posiciona automáticamente a sus hijos, un elemento hijo dentro de un Flujo no debería establecer sus posiciones x o y ni anclarse con ninguna de las propiedades anchor.

Para más información sobre el uso de los Flujos y otros tipos de posicionadores relacionados, véase Posicionadores de elementos.

Véase también Column, Row, Grid, Positioner, 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 flujo.

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

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

flow : enumeration

Esta propiedad contiene el flujo del diseño.

Los valores posibles son:

• Flow.LeftToRight (por defecto) - Los ítems se posicionan uno al lado del otro de acuerdo a layoutDirection hasta que se excede el ancho del Flow, luego se envuelven a la siguiente línea.
• Flow.TopToBottom - Los ítems se posicionan uno al lado del otro de arriba a abajo hasta que se excede la altura del Flow, luego se envuelven a la siguiente columna.

layoutDirection : enumeration

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

Los valores posibles son:

• Qt.LeftToRight (por defecto) - Los elementos se posicionan de arriba a abajo, y de izquierda a derecha. La dirección de flujo depende de la propiedad Flow::flow.
• Qt.RightToLeft - Los elementos se posicionan de arriba a abajo, y de derecha a izquierda. La dirección del flujo depende de la propiedad Flow::flow.

Véase también Grid::layoutDirection y Row::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 cada elemento adyacente, y su valor predeterminado es 0.

Véase también Grid::spacing.

Documentación de señales

positioningComplete()

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

Documentación del método

void forceLayout()

Flow normalmente posiciona 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 el Flow aún no se haya actualizado en consecuencia.

Este método fuerza al Flow a responder inmediatamente a cualquier cambio pendiente en sus hijos.

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