En esta página

Flow QML Type

Coloca sus elementos hijos uno al lado del otro, ajustando el contenido según sea necesario. Más...

Import Statement: import QtQuick
Inherits:

Item

Propiedades

Señales

Métodos

Descripción detallada

El elemento «Flow» coloca sus elementos secundarios como palabras en una página, ajustándolos para crear filas o columnas de elementos.

A continuación se muestra un elemento «Flow» 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 secundarios « Text » uno al lado del otro, ajustándolos según sea necesario:

Elementos de texto justificados como palabras en una página dentro de un posicionador Flow

Si un elemento dentro de un «Flow» no es de tipo « visible », o si tiene un ancho o una altura de 0, dicho elemento no se distribuirá y no será visible dentro del «Flow». Además, dado que un «Flow» coloca automáticamente a sus elementos secundarios, un elemento secundario dentro de un «Flow» no debe establecer sus posiciones « x » o « y », ni anclarse mediante ninguna de las propiedades « anchor ».

Para obtener más información sobre el uso de «Flow» y otros tipos de posicionadores relacionados, consulta «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. En el caso de un posicionador, esto se aplica a:

  • Los elementos que se crean o se reasignan como hijos del posicionador después de que este se haya creado
  • Elementos hijos que cambian su propiedad « Item::visible » de «false» a «true» y, por lo tanto, pasan a ser visibles

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

Nota: Esta transición no se aplica a los elementos que ya forman parte del posicionador en el momento de su creación. En este caso, se aplica en su lugar la transición « populate ».

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

bottomPadding : real

leftPadding : real

padding : real

rightPadding : real

topPadding : real

Estas propiedades definen el relleno que rodea el contenido.

effectiveLayoutDirection : enumeration [read-only]

Esta propiedad determina la dirección efectiva de la disposición del flujo.

Al utilizar la propiedad asociada LayoutMirroring::enabled para diseños de configuración regional, la dirección visual de la disposición del posicionador de cuadrícula se invertirá. Sin embargo, la propiedad layoutDirection permanecerá inalterada.

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

flow : enumeration

Esta propiedad controla el flujo de la maquetación.

Los valores posibles son:

  • Flow.LeftToRight (por defecto): los elementos se colocan uno al lado del otro según el flujo de texto de izquierda a derecha ( layoutDirection ) hasta que se supera la anchura del flujo, tras lo cual se ajustan a la línea siguiente.
  • Flow.TopToBottom: los elementos se colocan uno al lado del otro de arriba abajo hasta que se supera la altura del «Flow»; a continuación, se pasan a la siguiente columna.

layoutDirection : enumeration

Esta propiedad define la dirección de la maquetación.

Los valores posibles son:

  • Qt.LeftToRight (por defecto): los elementos se colocan de arriba abajo y de izquierda a derecha. La dirección del flujo depende de la propiedad Flow::flow.
  • Qt.RightToLeft: los elementos se colocan de arriba 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 determina que la transición se ejecute para los elementos que se hayan desplazado dentro del posicionador. En el caso de un posicionador, esto se aplica a:

  • Elementos secundarios que se desplazan cuando se ven desplazados debido a la adición, eliminación o reorganizació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. Sin embargo, hay que tener en cuenta que, para esta transición de movimiento, las listas ` ViewTransition.targetIndexes` y ` ViewTransition.targetItems` solo se establecen cuando esta transición se activa por la adición de otros elementos en el posicionador; en los demás 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 formen parte de este posicionador en el momento de su creación. La transición se ejecuta cuando se crea el posicionador 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 distancia en píxeles que se deja en blanco entre cada elemento adyacente, y el valor por defecto es 0.

Véase también Grid::spacing.

Documentación de Signal

positioningComplete()

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

Nota: El controlador correspondiente es onPositioningComplete.

Documentación del método

void forceLayout()

Por lo general, Flow posiciona sus elementos secundarios una vez por fotograma. Esto significa que, dentro de los bloques de script, es posible que los elementos secundarios subyacentes hayan cambiado, pero que Flow aún no se haya actualizado en consecuencia.

Este método obliga a Flow a responder inmediatamente a cualquier cambio pendiente en sus elementos secundarios.

Nota: en general, los métodos solo deben invocarse una vez que el componente haya finalizado su ejecución.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.