En esta página

Posicionadores de elementos

Los elementos posicionadores son elementos contenedores que gestionan las posiciones de los elementos en una interfaz de usuario declarativa. Los posicionadores se comportan de manera similar a los gestores de diseño que se utilizan con los Qt Widgets, salvo que también son contenedores por derecho propio.

Los posicionadores facilitan el trabajo con muchos elementos cuando es necesario organizarlos en un diseño regular.

Qt Quick Los diseños también se pueden utilizar para organizar elementos « Qt Quick » en una interfaz de usuario. Gestionan tanto las posiciones como los tamaños de los elementos en una interfaz de usuario declarativa, y son muy adecuados para interfaces de usuario redimensionables.

Posicionadores

En el conjunto básico de tipos gráficos de « Qt Quick » se incluye un conjunto de posicionadores estándar:

Column

Coloca a sus elementos secundarios en una columna

Flow

Coloca sus elementos secundarios uno al lado del otro, ajustando el texto según sea necesario

Grid

Coloca sus elementos secundarios en forma de cuadrícula

LayoutMirroring

Propiedad utilizada para reflejar el comportamiento del diseño

Positioner

Proporciona propiedades asociadas que contienen detalles sobre la ubicación de un elemento dentro de un posicionador

Row

Coloca sus elementos secundarios en una fila

Elementos de columna

Tres rectángulos apilados verticalmente con las etiquetas «Libros», «Música» y «Películas»

Column se utilizan para organizar elementos verticalmente. El siguiente ejemplo utiliza un elemento «Column» para organizar tres elementos « Rectangle » en un área definida por un « Item » exterior. La propiedad « spacing » se configura para incluir un pequeño espacio entre los rectángulos.

import QtQuick

Item {
    width: 310; height: 170

    Column {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.verticalCenter: parent.verticalCenter

        spacing: 5

        Rectangle { color: "lightblue"; radius: 10.0
                    width: 300; height: 50
                    Text { anchors.centerIn: parent
                           font.pointSize: 24; text: "Books" } }
        Rectangle { color: "gold"; radius: 10.0
                    width: 300; height: 50
                    Text { anchors.centerIn: parent
                           font.pointSize: 24; text: "Music" } }
        Rectangle { color: "lightgreen"; radius: 10.0
                    width: 300; height: 50
                    Text { anchors.centerIn: parent
                           font.pointSize: 24; text: "Movies" } }
    }
}

Ten en cuenta que, dado que «Column» hereda directamente de «Item», cualquier color de fondo debe añadirse al «Rectangle» padre, si así se desea.

Elementos «Row»

Tres rectángulos redondeados dispuestos horizontalmente

Row Los elementos «Row» se utilizan para organizar elementos horizontalmente. El siguiente ejemplo utiliza un elemento «Row» para organizar tres elementos « Rectangle » redondeados en un área definida por un «Rectangle» exterior de color. La propiedad « spacing » se configura para incluir un pequeño espacio entre los rectángulos.

Nos aseguramos de que el rectángulo padre sea lo suficientemente grande como para que quede algo de espacio alrededor de los bordes del elemento de fila centrado horizontalmente.

import QtQuick

Rectangle {
    width: 320; height: 110
    color: "#c0c0c0"

    Row {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.verticalCenter: parent.verticalCenter

        spacing: 5

        Rectangle { width: 100; height: 100; radius: 20.0
                    color: "#024c1c" }
        Rectangle { width: 100; height: 100; radius: 20.0
                    color: "#42a51c" }
        Rectangle { width: 100; height: 100; radius: 20.0
                    color: "white" }
    }
}

Elementos «Grid»

Cuatro rectángulos de colores en una cuadrícula de 2 por 2 con espacios entre ellos

Grid se utilizan para colocar elementos en una disposición de cuadrícula o tabla. En el siguiente ejemplo se utiliza un elemento «Grid» para colocar cuatro elementos « Rectangle » en una cuadrícula de 2 por 2. Al igual que con los demás posicionadores, el espaciado entre elementos se puede especificar mediante la propiedad « spacing ».

import QtQuick

Rectangle {
    width: 112; height: 112
    color: "#303030"

    Grid {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.verticalCenter: parent.verticalCenter
        columns: 2
        spacing: 6

        Rectangle { color: "#aa6666"; width: 50; height: 50 }
        Rectangle { color: "#aaaa66"; width: 50; height: 50 }
        Rectangle { color: "#9999aa"; width: 50; height: 50 }
        Rectangle { color: "#6666aa"; width: 50; height: 50 }
    }
}

No hay diferencia entre el espaciado horizontal y el vertical que se inserta entre los elementos, por lo que cualquier espacio adicional debe añadirse dentro de los propios elementos.

Cualquier celda vacía de la cuadrícula debe crearse definiendo elementos de marcador de posición en los lugares adecuados de la definición de la cuadrícula.

Elementos de flujo

Elementos de texto contenidos en un contenedor «Flow» estrecho Elementos de texto encerrados en un contenedor «Flow» más ancho

Flow Los elementos de flujo se utilizan para colocar elementos, como palabras, en una página, con filas o columnas de elementos que no se solapan.

Los elementos de flujo organizan los elementos de forma similar a los elementos de « Grid », con los elementos dispuestos en líneas a lo largo de un eje (el eje menor) y las líneas de elementos situadas una junto a otra a lo largo de otro eje (el eje mayor). La dirección del flujo, así como el espaciado entre elementos, se controlan mediante las propiedades « flow » y « spacing ».

El siguiente ejemplo muestra un elemento «Flow» que contiene varios elementos secundarios « Text ». Estos se disponen de forma similar a los que se muestran en las capturas de pantalla.

import QtQuick

Rectangle {
    color: "lightblue"
    width: 300; height: 200

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

Las principales diferencias entre los posicionadores «Grid» y «Flow» son que los elementos dentro de un «Flow» se ajustarán cuando se queden sin espacio en el eje menor, y que los elementos de una línea pueden no estar alineados con los de otra línea si los elementos no tienen tamaños uniformes. Al igual que con los elementos «Grid», no existe un control independiente del espaciado entre elementos y entre líneas de elementos.

Otras formas de posicionar elementos

Existen otras formas de posicionar elementos en una interfaz de usuario. Además de la técnica básica de especificar sus coordenadas directamente, se pueden posicionar de forma relativa a otros elementos mediante anclajes, o utilizarse con modelos de datos de QML, como el modelo de objetos.

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