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: |
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
Métodos
- void forceLayout()
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:

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