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