En esta página

Posicionadores y diseños

Existen varias formas de colocar elementos en QML.

A continuación se ofrece una breve descripción general. Para obtener más detalles, consulta «Conceptos importantes» en Qt Quick - Posicionamiento.

Posicionamiento manual

Los elementos se pueden colocar en coordenadas x, y específicas de la pantalla estableciendo sus propiedades x e y. Esto definirá su posición relativa a la esquina superior izquierda de su elemento padre, de acuerdo con las reglas del sistema de coordenadas visuales.

Si se combinan los enlaces en lugar de valores constantes para estas propiedades, el posicionamiento relativo también se consigue fácilmente estableciendo las coordenadas x e y en los enlaces correspondientes.

import QtQuick

Item {
    width: 100; height: 100

    Rectangle {
        // Manually positioned at 20,20
        x: 20
        y: 20
        width: 80
        height: 80
        color: "red"
    }
}

Cuadrado rojo situado mediante coordenadas x e y directas

Anclajes

El tipo « Item » permite anclar el elemento a otros elementos de tipo « Item ». Hay siete líneas de anclaje para cada elemento: izquierda, derecha, centro vertical, parte superior, parte inferior, línea de base y centro horizontal. Las tres líneas de anclaje verticales pueden anclarse a cualquiera de las tres líneas de anclaje verticales de otro elemento, y las cuatro líneas de anclaje horizontales pueden anclarse a las líneas de anclaje horizontales de otro elemento.

Para obtener más detalles, consulta «Posicionamiento con anclajes » y la documentación de anchors property.

import QtQuick

Item {
    width: 200; height: 200

    Rectangle {
        // Anchored to 20px off the top right corner of the parent
        anchors.right: parent.right
        anchors.top: parent.top
        anchors.margins: 20 // Sets all margins at once

        width: 80
        height: 80
        color: "orange"
    }

    Rectangle {
        // Anchored to 20px off the top center corner of the parent.
        // Notice the different group property syntax for 'anchors' compared to
        // the previous Rectangle. Both are valid.
        anchors { horizontalCenter: parent.horizontalCenter; top: parent.top; topMargin: 20 }

        width: 80
        height: 80
        color: "green"
    }
}

Rectángulos verdes y naranjas colocados mediante puntos de anclaje

Posicionadores

Para el caso habitual en el que se desea colocar un conjunto de elementos siguiendo un patrón regular, Qt Quick proporciona algunos tipos de posicionadores. Los elementos colocados en un posicionador se sitúan automáticamente de alguna manera; por ejemplo, un « Row » (alineador de fila) coloca los elementos de forma que queden adyacentes horizontalmente (formando una fila).

Para obtener más detalles, consulta «Posicionadores de elementos».

import QtQuick

Item {
    width: 300; height: 100

    Row { // The "Row" type lays out its child items in a horizontal line
        spacing: 20 // Places 20px of space between items

        Rectangle { width: 80; height: 80; color: "red" }
        Rectangle { width: 80; height: 80; color: "green" }
        Rectangle { width: 80; height: 80; color: "blue" }
    }
}

Cuadrados rojos, verdes y azules dispuestos en fila mediante posicionadores

Tipos de diseño

Los tipos de diseño funcionan de manera similar a los posicionadores, pero permiten un mayor refinamiento o restricciones en el diseño. En concreto, los tipos de diseño te permiten:

  • establecer la alineación del texto y otros elementos
  • redimensionar y rellenar automáticamente las áreas asignadas de la aplicación
  • establecer restricciones de tamaño, como dimensiones mínimas o máximas
  • establecer el espaciado entre elementos dentro del diseño
GroupBox {
    id: gridBox
    title: "Grid layout"
    Layout.fillWidth: true

    GridLayout {
        id: gridLayout
        rows: 3
        flow: GridLayout.TopToBottom
        anchors.fill: parent
        Label { text: "Line 1" }
        Label { text: "Line 2" }
        Label { text: "Line 3" }

        TextField { }
        TextField { }
        TextField { }

        TextArea {
            text: "This widget spans over three rows in the GridLayout.\n"
                  + "All items in the GridLayout are implicitly positioned from top to bottom."
            Layout.rowSpan: 3
            Layout.fillHeight: true
            Layout.fillWidth: true
        }
    }
}

El fragmento de código anterior procede del ejemplo «Basic Layouts ». El fragmento muestra la sencillez con la que se pueden añadir diversos campos y elementos a un diseño. El « GridLayout » se puede redimensionar y su formato se puede personalizar mediante diversas propiedades.

Para obtener más información sobre los tipos de diseño, visita:

Nota: Los diseños de «Qt Quick » se introdujeron en Qt 5.1 y requieren Qt Quick 2.1.

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