Rectangle QML Type
Dibuja un rectángulo relleno con un borde opcional. Más...
Propiedades
- antialiasing : bool
- border
- border.color : color
- border.pixelAligned : bool
- border.width : int
- bottomLeftRadius : real
(since 6.7) - bottomRightRadius : real
(since 6.7) - color : color
- gradient : var
- radius : real
- topLeftRadius : real
(since 6.7) - topRightRadius : real
(since 6.7)
Descripción detallada
Los elementos rectangulares se utilizan para rellenar áreas con colores lisos o degradados, y/o para crear un borde rectangular.
Apariencia
Cada elemento «Rectángulo» se rellena con un color sólido, especificado mediante la propiedad « color », o con un degradado, definido mediante un tipo de degradado y configurado mediante la propiedad « gradient ». Si se especifican tanto un color como un degradado, se utiliza el degradado.
Se puede añadir un borde opcional a un rectángulo con su propio color y grosor configurando las propiedades ` border.color ` y ` border.width `. Establezca el color en «transparente» para pintar un borde sin color de relleno.
También puede crear rectángulos redondeados utilizando la propiedad ` radius `. Dado que esto introduce bordes curvos en las esquinas de un rectángulo, puede ser conveniente establecer la propiedad ` Item::antialiasing ` para mejorar su aspecto. Para establecer los radios individualmente para las diferentes esquinas, puede utilizar las propiedades ` topLeftRadius`, ` topRightRadius`, ` bottomLeftRadius ` y ` bottomRightRadius`.
Ejemplo de uso

El siguiente ejemplo muestra los efectos de algunas de las propiedades más comunes en un elemento Rectangle, que en este caso se utiliza para crear un cuadrado:
import QtQuick
Rectangle {
width: 100
height: 100
color: "red"
border.color: "black"
border.width: 5
radius: 10
}Rendimiento
El uso de la propiedad « Item::antialiasing » mejora el aspecto de un rectángulo redondeado a costa del rendimiento de la representación. Se recomienda desactivar esta propiedad para los rectángulos en movimiento y activarla únicamente cuando estén quietos.
Véase también Image.
Documentación de la propiedad
antialiasing : bool
Se utiliza para determinar si el rectángulo debe aplicar suavizado o no. El suavizado proporciona información sobre las implicaciones de esta propiedad en el rendimiento.
El valor por defecto es «true» para los rectángulos con radio y «false» en los demás casos.
border group
El grosor y el color utilizados para dibujar el borde del rectángulo.
Un ancho de 1 crea una línea fina. Para que no haya línea, utiliza un ancho de 0 o un color transparente.
Nota: El ancho del borde del rectángulo no afecta a la geometría del propio rectángulo ni a su posición respecto a otros elementos si se utilizan anclajes.
El borde se representa dentro de los límites del rectángulo.
Si el valor de « pixelAligned » es « true » (el valor predeterminado), el ancho del borde renderizado se redondea a un número entero de píxeles, tras el escalado según la relación de píxeles del dispositivo. Si se establece « pixelAligned » en « false », se permitirán anchos de borde fraccionarios, lo que puede resultar conveniente cuando está activada la opción « antialiasing ».
bottomLeftRadius : real [since 6.7]
Esta propiedad define el radio que se utiliza para dibujar la esquina inferior izquierda.
Si no se establece el valor de `bottomLeftRadius`, se utilizará en su lugar ` radius `. Si `bottomLeftRadius` es cero, la esquina será aguda.
Esta propiedad se introdujo en Qt 6.7.
Véase también « radius », « topLeftRadius », « topRightRadius » y « bottomRightRadius ».
bottomRightRadius : real [since 6.7]
Esta propiedad especifica el radio que se utiliza para dibujar la esquina inferior derecha.
Si no se establece «bottomRightRadius», se utilizará en su lugar « radius ». Si «bottomRightRadius» es cero, la esquina será aguda.
Esta propiedad se introdujo en Qt 6.7.
Véase también « radius », « topLeftRadius », « topRightRadius » y « bottomLeftRadius ».
color : color
Esta propiedad determina el color que se utiliza para rellenar el rectángulo.
El color predeterminado es el blanco.

El siguiente ejemplo muestra rectángulos con colores especificados mediante notación hexadecimal y notación de colores con nombre:
Rectangle {
color: "#00B000"
width: 80; height: 80
}
Rectangle {
color: "steelblue"
y: 100; width: 80; height: 80
}Si se especifican tanto un degradado como un color, se utilizará el degradado.
Véase también gradient.
gradient : var
El degradado que se va a utilizar para rellenar el rectángulo.
Esta propiedad permite crear degradados simples verticales u horizontales. Se pueden crear otros degradados añadiendo rotación al rectángulo.

Rectangle {
width: 80; height: 80
color: "lightsteelblue"
}
Rectangle {
width: 80; height: 80
gradient: Gradient {
GradientStop { position: 0.0; color: "lightsteelblue" }
GradientStop { position: 1.0; color: "blue" }
}
}
Rectangle {
width: 80; height: 80
gradient: Gradient {
orientation: Gradient.Horizontal
GradientStop { position: 0.0; color: "lightsteelblue" }
GradientStop { position: 1.0; color: "blue" }
}
}
Rectangle {
width: 80; height: 80
rotation: 90
gradient: Gradient {
GradientStop { position: 0.0; color: "lightsteelblue" }
GradientStop { position: 1.0; color: "blue" }
}
}La propiedad también admite preajustes de degradado de QGradient::Preset. Sin embargo, hay que tener en cuenta que, dado que Rectangle solo admite degradados simples verticales u horizontales, cualquier preajuste con un ángulo no compatible se convertirá en la representación más cercana.
Rectangle {
width: 80; height: 80
gradient: Gradient.NightFade
}
Rectangle {
width: 80; height: 80
gradient: "SunnyMorning"
}Si se especifican tanto un degradado como un color, se utilizará el degradado.
Véase también Gradient y color.
radius : real
Esta propiedad define el radio de las esquinas que se utiliza para dibujar un rectángulo redondeado.
Si el radio es distinto de cero, el rectángulo se dibujará como un rectángulo redondeado; de lo contrario, se dibujará como un rectángulo normal. También se pueden establecer radios de esquina individuales (véase más abajo). Estos valores anularán el radio. Si no se establecen (estableciéndolos en ` undefined`), se utilizará el radio en su lugar.
Véase también « topLeftRadius », « topRightRadius », « bottomLeftRadius » y « bottomRightRadius ».
topLeftRadius : real [since 6.7]
Esta propiedad define el radio que se utiliza para dibujar la esquina superior izquierda.
Si no se establece el valor de `topLeftRadius`, se utilizará en su lugar ` radius `. Si `topLeftRadius` es cero, la esquina será afilada.
Esta propiedad se introdujo en Qt 6.7.
Véase también « radius », « topRightRadius », « bottomLeftRadius » y « bottomRightRadius ».
topRightRadius : real [since 6.7]
Esta propiedad contiene el radio que se utiliza para dibujar la esquina superior derecha.
Si no se establece el valor de `topRightRadius`, se utilizará en su lugar ` radius `. Si `topRightRadius` es cero, la esquina será puntiaguda.
Esta propiedad se introdujo en Qt 6.7.
Véase también « radius », « topLeftRadius », « bottomLeftRadius » y « bottomRightRadius ».
© 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.