Column QML Type
Coloca sus elementos secundarios en una columna. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
- add : Transition
- bottomPadding : real
- leftPadding : real
- move : Transition
- padding : real
- populate : Transition
- rightPadding : real
- spacing : real
- topPadding : real
Señales
Métodos
- void forceLayout()
Descripción detallada
«Column» es un tipo que coloca sus elementos secundarios a lo largo de una sola columna. Se puede utilizar como una forma práctica de colocar verticalmente una serie de elementos sin necesidad de utilizar anclajes.
A continuación se muestra una «Column» que contiene tres rectángulos de distintos tamaños:
Column {
spacing: 2
Rectangle { color: "red"; width: 50; height: 50 }
Rectangle { color: "green"; width: 20; height: 50 }
Rectangle { color: "blue"; width: 50; height: 20 }
}La «Column» coloca automáticamente estos elementos en una formación vertical, de esta manera:

Si un elemento dentro de una «Column» no es « visible », o si tiene un ancho o una altura de 0, dicho elemento no se distribuirá y no será visible dentro de la columna. Además, dado que una columna coloca automáticamente a sus elementos secundarios en posición vertical, un elemento secundario dentro de una columna no debe establecer su posición « y » ni anclarse verticalmente utilizando los anclajes « top », « bottom », « anchors.verticalCenter », « fill » o « centerIn ». Si necesitas realizar estas acciones, considera colocar los elementos sin utilizar una columna.
Tenga en cuenta que los elementos de una columna pueden utilizar la propiedad adjunta ` Positioner ` para acceder a más información sobre su posición dentro de la columna.
Para obtener más información sobre el uso de Column y otros tipos de posicionadores relacionados, consulta «Posicionadores de elementos».
Uso de transiciones
Una columna anima los elementos mediante transiciones específicas cuando se añaden elementos a la columna o se mueven dentro de ella.
Por ejemplo, la columna que se muestra a continuación establece la propiedad « move » en una « Transition » específica:
Column {
spacing: 2
Rectangle { color: "red"; width: 50; height: 50 }
Rectangle { id: greenRect; color: "green"; width: 20; height: 50 }
Rectangle { color: "blue"; width: 50; height: 20 }
move: Transition {
NumberAnimation { properties: "x,y"; duration: 1000 }
}
focus: true
Keys.onSpacePressed: greenRect.visible = !greenRect.visible
}Al pulsar la tecla Espacio, el valor de « visible » del elemento verde « Rectangle » cambia. A medida que aparece y desaparece, el elemento azul « Rectangle » se desplaza dentro de la columna, y la transición « move » se aplica automáticamente al elemento azul « Rectangle »:
Véase también « Row» , « Grid », « Flow », « Positioner », « ColumnLayout » 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.
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 al ser movidos debido a la incorporación, eliminación o reorganización de otros elementos en el posicionador
- Elementos secundarios que se reubican 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 incorporació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 queda libre entre elementos adyacentes. El espaciado predeterminado 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, Column posiciona 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 Column aún no se haya actualizado en consecuencia.
Este método obliga a la columna 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.