Row QML Type
Coloca sus elementos secundarios en una fila. Más...
| Import Statement: | import QtQuick |
| Inherits: |
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
Métodos
- void forceLayout()
Descripción detallada
Row es un tipo que coloca sus elementos secundarios a lo largo de una sola fila. Se puede utilizar como una forma práctica de colocar horizontalmente una serie de elementos sin necesidad de utilizar anclajes.
A continuación se muestra una «Row» que contiene tres rectángulos de distintos 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 }
}El «Row» coloca automáticamente estos elementos en una disposición horizontal, de la siguiente manera:

Si un elemento dentro de un Row no es de tipo « visible », o si tiene un ancho o una altura de 0, el elemento no se distribuirá y no será visible dentro de la fila. Además, dado que un Row coloca automáticamente a sus elementos secundarios en horizontal, un elemento secundario dentro de un Row no debe establecer su posición « x » ni anclarse horizontalmente utilizando los anclajes « left », « right », « anchors.horizontalCenter », « fill » o « centerIn ». Si necesitas realizar estas acciones, plantéate colocar los elementos sin utilizar una fila.
Tenga en cuenta que los elementos de una fila pueden utilizar la propiedad adjunta « Positioner » para acceder a más información sobre su posición dentro de la fila.
Para obtener más información sobre el uso de «Row» y otros tipos de posicionadores relacionados, consulta «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. 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 de diseño efectiva de la fila.
Al utilizar la propiedad asociada LayoutMirroring::enabled para diseños de configuración regional, la dirección visual del diseño del posicionador de filas se invertirá. Sin embargo, la propiedad layoutDirection permanecerá sin cambios.
Véase también « Row::layoutDirection » y « LayoutMirroring ».
layoutDirection : enumeration
Esta propiedad contiene la dirección de alineación (layoutDirection) de la fila.
Valores posibles:
| Constante | Descripción |
|---|---|
Qt.LeftToRight | (por defecto) Los elementos se disponen de izquierda a derecha. Si se establece explícitamente el ancho de la fila, el ancla izquierda permanece a la izquierda de la fila. |
Qt.RightToLeft | Los elementos se disponen de derecha a izquierda. Si se establece explícitamente el ancho de la fila, el anclaje derecho permanece a la derecha de la fila. |
Véase también Grid::layoutDirection y Flow::layoutDirection.
move : Transition
Esta propiedad determina que la transición se ejecute para los elementos que se hayan movido dentro del posicionador. En el caso de un posicionador, esto se aplica a:
- Elementos secundarios que se desplazan al ser movidos 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 desplazamiento, 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 libre entre elementos adyacentes. El espaciado 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, el elemento `Row` posiciona a sus elementos hijos una vez por fotograma. Esto significa que, dentro de los bloques de script, es posible que los elementos hijos subyacentes hayan cambiado, pero que el elemento `Row` aún no se haya actualizado en consecuencia.
Este método obliga a la fila 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.